xref: /illumos-gate/usr/src/lib/smbsrv/libsmbns/common/libsmbns.h (revision 1fa2a66491e7d8ae0be84e7da4da8e812480c710)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License (the "License").
6  * You may not use this file except in compliance with the License.
7  *
8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9  * or http://www.opensolaris.org/os/licensing.
10  * See the License for the specific language governing permissions
11  * and limitations under the License.
12  *
13  * When distributing Covered Code, include this CDDL HEADER in each
14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15  * If applicable, add the following below this CDDL HEADER, with the
16  * fields enclosed by brackets "[]" replaced with your own identifying
17  * information: Portions Copyright [yyyy] [name of copyright owner]
18  *
19  * CDDL HEADER END
20  */
21 /*
22  * Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
23  * Copyright 2019 Nexenta by DDN, Inc. All rights reserved.
24  */
25 
26 #ifndef	_LIBSMBNS_H
27 #define	_LIBSMBNS_H
28 
29 #include <ldap.h>
30 #include <smbsrv/libsmb.h>
31 
32 #ifdef	__cplusplus
33 extern "C" {
34 #endif
35 
36 /* ADS typedef/data structures and functions */
37 
38 
39 typedef struct smb_ads_handle {
40 	char *domain;		/* ADS domain (in lower case) */
41 	char *domain_dn;	/* domain in Distinquish Name format */
42 	char *ip_addr;		/* ip addr in string format */
43 	char *hostname;		/* fully qualified hostname */
44 	char *site;		/* local ADS site */
45 	LDAP *ld;		/* LDAP handle */
46 } smb_ads_handle_t;
47 
48 typedef struct smb_ads_host_info {
49 	char name[MAXHOSTNAMELEN];  /* fully qualified hostname */
50 	int port;		/* ldap port */
51 	int priority;		/* DNS SRV record priority */
52 	int weight;		/* DNS SRV record weight */
53 	uint32_t flags;		/* DC flags */
54 	smb_inaddr_t ipaddr;	/* network byte order */
55 } smb_ads_host_info_t;
56 
57 /*
58  * Return status codes for the ads functions.
59  */
60 typedef enum smb_ads_status {
61 	SMB_ADS_SUCCESS = 0,
62 	/* errno values... */
63 	SMB_ADS_ERRNO_GAP = 200,
64 	SMB_ADS_KRB5_INIT_CTX,
65 	SMB_ADS_KRB5_CC_DEFAULT,
66 	SMB_ADS_KRB5_PARSE_PRINCIPAL,
67 	SMB_ADS_KRB5_GET_INIT_CREDS_PW,
68 	SMB_ADS_KRB5_CC_INITIALIZE,
69 	SMB_ADS_KRB5_CC_STORE_CRED,
70 	SMB_ADS_CANT_LOCATE_DC,
71 	SMB_ADS_LDAP_INIT,
72 	SMB_ADS_LDAP_SETOPT,
73 	SMB_ADS_LDAP_SET_DOM,
74 	SMB_ADS_LDAP_SASL_BIND,
75 
76 	SMB_ADJOIN_ERR_GEN_PWD,
77 	SMB_ADJOIN_ERR_GET_DCLEVEL,
78 	SMB_ADJOIN_ERR_ADD_TRUST_ACCT,
79 	SMB_ADJOIN_ERR_MOD_TRUST_ACCT,
80 	SMB_ADJOIN_ERR_DUP_TRUST_ACCT,
81 	SMB_ADJOIN_ERR_TRUST_ACCT,
82 	SMB_ADJOIN_ERR_INIT_KRB_CTX,
83 	SMB_ADJOIN_ERR_GET_SPNS,
84 	SMB_ADJOIN_ERR_KSETPWD,
85 	SMB_ADJOIN_ERR_UPDATE_CNTRL_ATTR,
86 	SMB_ADJOIN_ERR_WRITE_KEYTAB,
87 	SMB_ADJOIN_ERR_IDMAP_SET_DOMAIN,
88 	SMB_ADJOIN_ERR_IDMAP_REFRESH,
89 	SMB_ADJOIN_ERR_COMMIT_KEYTAB,
90 	SMB_ADJOIN_ERR_AUTH_NETLOGON,
91 	SMB_ADJOIN_ERR_STORE_PROPS,
92 } smb_ads_status_t;
93 
94 /* ADS functions */
95 extern void smb_ads_init(void);
96 extern void smb_ads_fini(void);
97 extern void smb_ads_refresh(boolean_t);
98 extern smb_ads_handle_t *smb_ads_open(void);
99 extern void smb_ads_close(smb_ads_handle_t *);
100 extern int smb_ads_publish_share(smb_ads_handle_t *, const char *, const char *,
101     const char *, const char *);
102 extern int smb_ads_remove_share(smb_ads_handle_t *, const char *, const char *,
103     const char *, const char *);
104 extern int smb_ads_build_unc_name(char *, int, const char *, const char *);
105 extern int smb_ads_lookup_share(smb_ads_handle_t *, const char *, const char *,
106     char *);
107 extern int smb_ads_add_share(smb_ads_handle_t *, const char *, const char *,
108     const char *);
109 extern smb_ads_status_t smb_ads_join(char *, char *, char *, char *);
110 extern void smb_ads_log_errmsg(smb_ads_status_t);
111 extern const char *smb_ads_strerror(int);
112 extern uint32_t smb_ads_lookup_msdcs(char *, smb_dcinfo_t *);
113 extern smb_ads_host_info_t *smb_ads_find_host(char *);
114 
115 /* DYNDNS functions */
116 extern void *dyndns_publisher(void *);
117 extern void dyndns_start(void);
118 extern void dyndns_stop(void);
119 extern int dyndns_update(char *);
120 extern void dyndns_update_zones(void);
121 extern void dyndns_clear_zones(void);
122 
123 /* Kerberos cache management function */
124 extern int smb_ccache_init(char *, char *);
125 extern void smb_ccache_remove(char *);
126 
127 /* NETBIOS Functions */
128 extern int smb_netbios_start(void);
129 extern void smb_netbios_stop(void);
130 extern void smb_netbios_name_reconfig(void);
131 
132 /* Browser Functions */
133 extern void smb_browser_reconfig(void);
134 extern boolean_t smb_browser_netlogon(char *, char *, uint32_t);
135 
136 
137 #ifdef	__cplusplus
138 }
139 #endif
140 
141 #endif	/* _LIBSMBNS_H */
142