xref: /illumos-gate/usr/src/lib/libsmbfs/netsmb/smb_lib.h (revision 85e6b6747d07050e01ec91acef2453655821f9ab)
1 /*
2  * Copyright (c) 2000-2001 Boris Popov
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  * 3. All advertising materials mentioning features or use of this software
14  *    must display the following acknowledgement:
15  *    This product includes software developed by Boris Popov.
16  * 4. Neither the name of the author nor the names of any co-contributors
17  *    may be used to endorse or promote products derived from this software
18  *    without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
21  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
24  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30  * SUCH DAMAGE.
31  *
32  * $Id: smb_lib.h,v 1.21.82.2 2005/06/02 00:55:39 lindak Exp $
33  */
34 
35 /*
36  * Copyright (c) 2008, 2010, Oracle and/or its affiliates. All rights reserved.
37  * Copyright 2013 Nexenta Systems, Inc.  All rights reserved.
38  */
39 
40 #ifndef _NETSMB_SMB_LIB_H_
41 #define	_NETSMB_SMB_LIB_H_
42 
43 /*
44  * Internal interface exported to our commands in:
45  *	usr/src/cmd/fs.d/smbclnt/
46  */
47 
48 #include <sys/types.h>
49 #include <sys/socket.h>
50 #include <netinet/in.h>
51 #include <arpa/inet.h>
52 #include <sys/byteorder.h>
53 
54 #include <netsmb/smbfs_api.h>
55 #include <netsmb/smb_dev.h>
56 
57 extern const char smbutil_std_opts[];
58 #define	STDPARAM_OPT	smbutil_std_opts
59 
60 /*
61  * bits to indicate the source of error
62  */
63 #define	SMB_ERRTYPE_MASK	0xf0000
64 #define	SMB_SYS_ERROR		0x00000
65 #define	SMB_RAP_ERROR		0x10000
66 #define	SMB_NB_ERROR		0x20000
67 
68 /*
69  * Size of all LM/NTLM hashes (16 bytes).
70  * The driver needs to know this, so it's
71  * defined by smb_dev.h
72  */
73 #define	NTLM_HASH_SZ		SMBIOC_HASH_SZ
74 #define	NTLM_CHAL_SZ		8	/* challenge size */
75 
76 /*
77  * This is what goes across the door call to the IOD
78  * when asking for a new connection.
79  */
80 struct smb_iod_ssn {
81 	struct smbioc_ossn iod_ossn;
82 	int		iod_authflags;	/* SMB_AT_x */
83 	uchar_t		iod_nthash[NTLM_HASH_SZ];
84 	uchar_t		iod_lmhash[NTLM_HASH_SZ];
85 	/* Kerberos cred. cache res. name? */
86 };
87 typedef struct smb_iod_ssn smb_iod_ssn_t;
88 
89 
90 /*
91  * SMB work context. Used to store all values which are necessary
92  * to establish connection to an SMB server.
93  */
94 struct smb_ctx {
95 	int		ct_flags;	/* SMBCF_ */
96 	int		ct_dev_fd;	/* device handle */
97 	int		ct_door_fd;	/* to smbiod */
98 	int		ct_parsedlevel;
99 	int		ct_minlevel;
100 	int		ct_maxlevel;
101 	char		*ct_fullserver; /* orig. server name from cmd line */
102 	char		*ct_srvaddr_s;	/* hostname or IP address of server */
103 	struct addrinfo *ct_addrinfo;	/* IP addresses of the server */
104 	struct nb_ctx	*ct_nb;		/* NetBIOS info. */
105 	char		*ct_locname;	/* local (machine) name */
106 	smb_iod_ssn_t	ct_iod_ssn;
107 	/* smbioc_oshare_t	ct_sh; XXX */
108 	int		ct_minauth;
109 	int		ct_shtype_req;	/* share type wanted */
110 	char		*ct_origshare;
111 	char		*ct_home;
112 	char		*ct_rpath;	/* remote file name */
113 
114 	/* Connection setup SMB stuff. */
115 	/* Strings from the SMB negotiate response. */
116 	char		*ct_srv_OS;
117 	char		*ct_srv_LM;
118 	uint32_t	ct_clnt_caps;
119 
120 	/* NTLM auth. stuff */
121 	uchar_t		ct_clnonce[NTLM_CHAL_SZ];
122 	uchar_t		ct_srv_chal[NTLM_CHAL_SZ];
123 	char		ct_password[SMBIOC_MAX_NAME];
124 
125 	/* See ssp.c */
126 	void		*ct_ssp_ctx;
127 	smbioc_ssn_work_t ct_work;
128 };
129 
130 
131 /*
132  * Short-hand for some of the substruct fields above
133  */
134 #define	ct_ssn		ct_iod_ssn.iod_ossn
135 #define	ct_vopt		ct_iod_ssn.iod_ossn.ssn_vopt
136 #define	ct_owner	ct_iod_ssn.iod_ossn.ssn_owner
137 #define	ct_srvaddr	ct_iod_ssn.iod_ossn.ssn_srvaddr
138 #define	ct_domain	ct_iod_ssn.iod_ossn.ssn_domain
139 #define	ct_user 	ct_iod_ssn.iod_ossn.ssn_user
140 #define	ct_srvname 	ct_iod_ssn.iod_ossn.ssn_srvname
141 #define	ct_authflags	ct_iod_ssn.iod_authflags
142 #define	ct_nthash	ct_iod_ssn.iod_nthash
143 #define	ct_lmhash	ct_iod_ssn.iod_lmhash
144 
145 #define	ct_sopt		ct_work.wk_sopt
146 #define	ct_iods		ct_work.wk_iods
147 #define	ct_tran_fd	ct_work.wk_iods.is_tran_fd
148 #define	ct_hflags	ct_work.wk_iods.is_hflags
149 #define	ct_hflags2	ct_work.wk_iods.is_hflags2
150 #define	ct_vcflags	ct_work.wk_iods.is_vcflags
151 #define	ct_ssn_key	ct_work.wk_iods.is_ssn_key
152 #define	ct_mac_seqno	ct_work.wk_iods.is_next_seq
153 #define	ct_mackeylen	ct_work.wk_iods.is_u_maclen
154 #define	ct_mackey	ct_work.wk_iods.is_u_mackey.lp_ptr
155 
156 
157 /*
158  * Bits in smb_ctx_t.ct_flags
159  */
160 #define	SMBCF_NOPWD		    0x0001 /* don't ask for a password */
161 #define	SMBCF_SRIGHTS		    0x0002 /* share access rights supplied */
162 #define	SMBCF_LOCALE		    0x0004 /* use current locale */
163 #define	SMBCF_CMD_DOM		    0x0010 /* CMD specified domain */
164 #define	SMBCF_CMD_USR		    0x0020 /* CMD specified user */
165 #define	SMBCF_CMD_PW		    0x0040 /* CMD specified password */
166 #define	SMBCF_RESOLVED		    0x8000 /* structure has been verified */
167 #define	SMBCF_KCBAD		0x00080000 /* keychain password failed */
168 #define	SMBCF_KCFOUND		0x00100000 /* password is from keychain */
169 #define	SMBCF_BROWSEOK		0x00200000 /* browser dialogue may be used */
170 #define	SMBCF_AUTHREQ		0x00400000 /* auth. dialog requested */
171 #define	SMBCF_KCSAVE		0x00800000 /* add to keychain requested */
172 #define	SMBCF_XXX		0x01000000 /* mount-all, a very bad thing */
173 #define	SMBCF_SSNACTIVE		0x02000000 /* session setup succeeded */
174 #define	SMBCF_KCDOMAIN		0x04000000 /* use domain in KC lookup */
175 
176 
177 /*
178  * Context management
179  */
180 
181 int  smb_ctx_init(struct smb_ctx *);
182 void smb_ctx_done(struct smb_ctx *);
183 int  smb_open_driver(void);
184 
185 int  smb_ctx_gethandle(struct smb_ctx *);
186 int  smb_ctx_findvc(struct smb_ctx *);
187 int  smb_ctx_newvc(struct smb_ctx *);
188 
189 /*
190  * I/O daemon stuff
191  */
192 
193 #define	SMBIOD_RUNDIR	"/var/run/smbiod"
194 #define	SMBIOD_SVC_DOOR	SMBIOD_RUNDIR "/.svc"
195 #define	SMBIOD_USR_DOOR	SMBIOD_RUNDIR "/%d"
196 #define	SMBIOD_START	1
197 
198 int  smb_iod_cl_newvc(smb_ctx_t *ctx);
199 char *smb_iod_door_path(void);
200 int smb_iod_open_door(int *);
201 int smb_iod_connect(struct smb_ctx *);
202 int smb_iod_work(struct smb_ctx *);
203 
204 /*
205  * Other stuff
206  */
207 
208 int  smb_open_rcfile(char *);
209 void smb_close_rcfile(void);
210 
211 void smb_simplecrypt(char *dst, const char *src);
212 int  smb_simpledecrypt(char *dst, const char *src);
213 
214 int	nls_setrecode(const char *, const char *);
215 int	nls_setlocale(const char *);
216 char	*nls_str_toext(char *, const char *);
217 char	*nls_str_toloc(char *, const char *);
218 void	*nls_mem_toext(void *, const void *, int);
219 void	*nls_mem_toloc(void *, const void *, int);
220 char	*nls_str_upper(char *, const char *);
221 char	*nls_str_lower(char *, const char *);
222 
223 char *smb_getprogname();
224 #define	__progname smb_getprogname()
225 
226 #endif /* _NETSMB_SMB_LIB_H_ */
227