xref: /illumos-gate/usr/src/lib/smbsrv/libsmbns/common/libsmbns.h (revision dd72704bd9e794056c558153663c739e2012d721)
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_OTHER,
68 	SMB_ADS_KRB5_GET_INIT_CREDS_PW,
69 	SMB_ADS_KRB5_GET_INIT_CREDS_SKEW,
70 	SMB_ADS_KRB5_CC_INITIALIZE,
71 	SMB_ADS_KRB5_CC_STORE_CRED,
72 	SMB_ADS_CANT_LOCATE_DC,
73 	SMB_ADS_LDAP_INIT,
74 	SMB_ADS_LDAP_SETOPT,
75 	SMB_ADS_LDAP_SET_DOM,
76 	SMB_ADS_LDAP_SASL_BIND,
77 
78 	SMB_ADJOIN_ERR_GEN_PWD,
79 	SMB_ADJOIN_ERR_GET_DCLEVEL,
80 	SMB_ADJOIN_ERR_ADD_TRUST_ACCT,
81 	SMB_ADJOIN_ERR_MOD_TRUST_ACCT,
82 	SMB_ADJOIN_ERR_DUP_TRUST_ACCT,
83 	SMB_ADJOIN_ERR_TRUST_ACCT,
84 	SMB_ADJOIN_ERR_INIT_KRB_CTX,
85 	SMB_ADJOIN_ERR_GET_SPNS,
86 	SMB_ADJOIN_ERR_KSETPWD,
87 	SMB_ADJOIN_ERR_UPDATE_CNTRL_ATTR,
88 	SMB_ADJOIN_ERR_WRITE_KEYTAB,
89 	SMB_ADJOIN_ERR_IDMAP_SET_DOMAIN,
90 	SMB_ADJOIN_ERR_IDMAP_REFRESH,
91 	SMB_ADJOIN_ERR_COMMIT_KEYTAB,
92 	SMB_ADJOIN_ERR_AUTH_NETLOGON,
93 	SMB_ADJOIN_ERR_STORE_PROPS,
94 } smb_ads_status_t;
95 
96 /* ADS functions */
97 extern void smb_ads_init(void);
98 extern void smb_ads_fini(void);
99 extern void smb_ads_refresh(boolean_t);
100 extern smb_ads_handle_t *smb_ads_open(void);
101 extern void smb_ads_close(smb_ads_handle_t *);
102 extern int smb_ads_publish_share(smb_ads_handle_t *, const char *, const char *,
103     const char *, const char *);
104 extern int smb_ads_remove_share(smb_ads_handle_t *, const char *, const char *,
105     const char *, const char *);
106 extern int smb_ads_build_unc_name(char *, int, const char *, const char *);
107 extern int smb_ads_lookup_share(smb_ads_handle_t *, const char *, const char *,
108     char *);
109 extern int smb_ads_add_share(smb_ads_handle_t *, const char *, const char *,
110     const char *);
111 extern smb_ads_status_t smb_ads_join(char *, char *, char *, char *, char *);
112 extern void smb_ads_log_errmsg(smb_ads_status_t);
113 extern const char *smb_ads_strerror(int);
114 extern uint32_t smb_ads_lookup_msdcs(char *, smb_dcinfo_t *);
115 extern smb_ads_host_info_t *smb_ads_find_host(char *);
116 
117 /* DYNDNS functions */
118 extern void *dyndns_publisher(void *);
119 extern void dyndns_start(void);
120 extern void dyndns_stop(void);
121 extern int dyndns_update(char *);
122 extern void dyndns_update_zones(void);
123 extern void dyndns_clear_zones(void);
124 
125 /* Kerberos cache management function */
126 extern int smb_ccache_init(char *, char *);
127 extern void smb_ccache_remove(char *);
128 
129 /* NETBIOS Functions */
130 extern int smb_netbios_start(void);
131 extern void smb_netbios_stop(void);
132 extern void smb_netbios_name_reconfig(void);
133 
134 /* Browser Functions */
135 extern void smb_browser_reconfig(void);
136 extern boolean_t smb_browser_netlogon(char *, char *, uint32_t);
137 
138 
139 #ifdef	__cplusplus
140 }
141 #endif
142 
143 #endif	/* _LIBSMBNS_H */
144