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, Version 1.0 only
6 * (the "License").  You may not use this file except in compliance
7 * with the License.
8 *
9 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10 * or http://www.opensolaris.org/os/licensing.
11 * See the License for the specific language governing permissions
12 * and limitations under the License.
13 *
14 * When distributing Covered Code, include this CDDL HEADER in each
15 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16 * If applicable, add the following below this CDDL HEADER, with the
17 * fields enclosed by brackets "[]" replaced with your own identifying
18 * information: Portions Copyright [yyyy] [name of copyright owner]
19 *
20 * CDDL HEADER END
21 */
22/*
23 * Copyright 2004 Sun Microsystems, Inc.  All rights reserved.
24 * Use is subject to license terms.
25 *
26 * nfs_inet.h contains definitions specific to inetboot's nfs implementation.
27 */
28
29#ifndef _NFS_INET_H
30#define	_NFS_INET_H
31
32#pragma ident	"%Z%%M%	%I%	%E% SMI"
33
34#ifdef	__cplusplus
35extern "C" {
36#endif
37
38#include <netinet/in.h>
39#include <sys/socket.h>
40#include <net/if.h>
41#include <netinet/if_ether.h>
42#include <netinet/in_systm.h>
43#include <netinet/ip.h>
44#include <netinet/udp.h>
45#include <sys/saio.h>
46#include <rpcsvc/nfs_prot.h>
47#include <rpcsvc/nfs4_prot.h>
48#include "clnt.h"
49#include <sys/vfs.h>
50#include <sys/dirent.h>
51
52#define	NFSBUF_SIZE	(READ_SIZE+1024)
53#define	READ_SIZE	(8192)	/* NFS readsize */
54#define	NFS_READ_DECR	(1024)	/* NFS readsize decrement */
55#define	NFS3BUF_SIZE	(READ3_SIZE+1024)
56#define	READ3_SIZE	(32 * 1024)	/* NFS3 readsize */
57#define	NFS4BUF_SIZE	(READ4_SIZE+1024)
58#define	READ4_SIZE	(32 * 1024)	/* NFS4 readsize */
59#define	NFS4_MAX_UTF8STRING	(8 * 1024)
60#define	NFS4_MAX_BITWORDS	(2)
61#define	NFS_MAX_FERRS	(3)	/* MAX frame errors before decr read size */
62#define	NFS_REXMIT_MIN	(3)	/* NFS retry min in secs */
63#define	NFS_REXMIT_MAX	(15)	/* NFS retry max in secs */
64
65extern int nfs_readsize;
66extern struct nfs_file roothandle;
67extern CLIENT *root_CLIENT;
68
69/*
70 * Boot specific V4 fh with maximum allowed data statically allocated
71 */
72struct nfs_bfh4 {
73	uint_t len;
74	char data[NFS4_FHSIZE];
75};
76
77/*
78 * Boot specific V3 fh with maximum allowed data statically allocated
79 */
80struct nfs_bfh3 {
81	uint_t len;
82	char data[NFS3_FHSIZE];
83};
84
85union _nfs_fh {
86	nfs_fh fh2;
87	struct nfs_bfh3 fh3;
88	struct nfs_bfh4 fh4;
89};
90
91union _nfs_cookie {
92	nfscookie cookie2;
93	cookie3 cookie3;
94	nfs_cookie4 cookie4;
95};
96
97union _nfs_ftype {
98	ftype type2;
99	ftype3 type3;
100	nfs_ftype4 type4;
101};
102
103/*
104 * NFS: This structure represents the current open file.
105 */
106struct nfs_file {
107	int version;
108	ulong_t offset;
109	union _nfs_ftype ftype;
110	union _nfs_fh fh;
111	union _nfs_cookie cookie;
112};
113
114struct nfs_fid {
115	ushort_t nf_len;
116	ushort_t nf_pad;
117	struct nfs_fh fh;
118};
119
120#define	cfile_is_dir(cf)    (((cf)->version == NFS_VERSION) ?	\
121				((cf)->ftype.type2 == NFDIR) :	\
122				(((cf)->version == NFS_V3) ?	\
123				((cf)->ftype.type3 == NF3DIR) : \
124				(((cf)->version == NFS_V4) ?	\
125				((cf)->ftype.type4 == NF4DIR) : 0)))
126
127#define	cfile_is_lnk(cf)    (((cf)->version == NFS_VERSION) ?	\
128				((cf)->ftype.type2 == NFLNK) :	\
129				(((cf)->version == NFS_V3) ?	\
130				((cf)->ftype.type3 == NF3LNK) : \
131				(((cf)->version == NFS_V4) ?	\
132				((cf)->ftype.type4 == NF4LNK) : 0)))
133
134/*
135 * Predefine an attribute bitmap that inetboot will most likely be
136 * interested in.
137 */
138typedef union attr4_bitmap1_u {
139	struct {
140		unsigned int
141#ifdef _BIT_FIELDS_HTOL
142		b_pad4:			11,
143		b_fattr4_fileid:	1,
144		b_fattr4_filehandle:	1,
145		b_pad3:			10,
146		b_fattr4_fsid:		1,
147		b_pad2:			3,
148		b_fattr4_size:		1,
149		b_pad1:			2,
150		b_fattr4_type:		1,
151		b_supported_attrs:	1;
152#endif
153#ifdef _BIT_FIELDS_LTOH
154		b_supported_attrs:	1,
155		b_fattr4_type:		1,
156		b_pad1:			2,
157		b_fattr4_size:		1,
158		b_pad2:			3,
159		b_fattr4_fsid:		1,
160		b_pad3:			10,
161		b_fattr4_filehandle:	1,
162		b_fattr4_fileid:	1,
163		b_pad4:			11;
164#endif
165	} bitmap_s;
166	uint_t word;
167} attr4_bitmap1_t;
168
169#define	bm_supported_attrs	bitmap_s.b_supported_attrs
170#define	bm_fattr4_type		bitmap_s.b_fattr4_type
171#define	bm_fattr4_size		bitmap_s.b_fattr4_size
172#define	bm_fattr4_fsid		bitmap_s.b_fattr4_fsid
173#define	bm_fattr4_fileid	bitmap_s.b_fattr4_fileid
174#define	bm_fattr4_filehandle	bitmap_s.b_fattr4_filehandle
175
176typedef	union attr4_bitmap2_u {
177	struct {
178		unsigned int
179#ifdef _BIT_FIELDS_HTOL
180		b_pad4:			10,
181		b_fattr4_time_modify:	1,
182		b_fattr4_time_metadata:	1,
183		b_pad3:			4,
184		b_fattr4_time_access:	1,
185		b_pad2:			13,
186		b_fattr4_mode:		1,
187		b_pad1:			1;
188#endif
189#ifdef _BIT_FIELDS_LTOH
190		b_pad1:			1,
191		b_fattr4_mode:		1,
192		b_pad2:			13,
193		b_fattr4_time_access:	1,
194		b_pad3:			4,
195		b_fattr4_time_metadata:	1,
196		b_fattr4_time_modify:	1,
197		b_pad4:			10;
198#endif
199	} bitmap_s;
200	uint_t word;
201} attr4_bitmap2_t;
202
203#define	bm_fattr4_mode		bitmap_s.b_fattr4_mode
204#define	bm_fattr4_time_access	bitmap_s.b_fattr4_time_access
205#define	bm_fattr4_time_metadata	bitmap_s.b_fattr4_time_metadata
206#define	bm_fattr4_time_modify	bitmap_s.b_fattr4_time_modify
207
208typedef struct b_bitmap4 {
209	uint_t b_bitmap_len;
210	uint_t b_bitmap_val[NFS4_MAX_BITWORDS];
211} b_bitmap4_t;
212
213/*
214 * Define a usable set of v4 atttributes for inetboot.
215 */
216typedef struct b_fattr4_s {
217	b_bitmap4_t	b_supported_attrs;
218	nfs_ftype4	b_fattr4_type;
219	uint64_t	b_fattr4_size;
220	fsid4		b_fattr4_fsid;
221	struct nfs_bfh4	b_fattr4_filehandle;
222	uint64_t	b_fattr4_fileid;
223	mode4		b_fattr4_mode;
224	nfstime4	b_fattr4_time_access;
225	nfstime4	b_fattr4_time_metadata;
226	nfstime4	b_fattr4_time_modify;
227} b_fattr4_t;
228
229/*
230 * common to putfh and putfhroot.
231 */
232typedef struct putfh4arg_s {
233	uint_t		pf_opnum;	/* can either be putfh or putrootfh */
234	struct nfs_bfh4	pf_filehandle;	/* only used by putfh */
235} putfh4arg_t;
236
237/*
238 * Use this struct to construct our OTW compound procedures.  Layout makes for
239 * easy XDR'ing. Include putfh.
240 */
241typedef union compound_u {
242	struct {
243		utf8string	tag;
244		uint_t		minorversion;	/* 0 */
245		uint_t		argarray_len;	/* 1 + n for putfh */
246		bool_t		isputrootfh;	/* flag */
247		putfh4arg_t	opputfh;	/* putfh args */
248	} compound_ua_s;
249	struct {
250		nfsstat4	status;		/* status of last op */
251		utf8string	tag;
252		uint_t		resarray_len;	/* 1 + n for putfh */
253		uint_t		opputfh;	/* putfh opnum */
254		nfsstat4	putfh_status;	/* putfh status */
255	} compound_ur_s;
256} b_compound_t;
257
258/*
259 * Define some macros for easy access into the compound structrue
260 */
261#define	ca_tag compound_ua_s.tag
262#define	ca_minorversion compound_ua_s.minorversion
263#define	ca_argarray_len compound_ua_s.argarray_len
264#define	ca_isputrootfh compound_ua_s.isputrootfh
265#define	ca_opputfh compound_ua_s.opputfh
266
267#define	cr_status compound_ur_s.status
268#define	cr_tag compound_ur_s.tag
269#define	cr_resarray_len compound_ur_s.resarray_len
270#define	cr_opputfh compound_ur_s.opputfh
271#define	cr_putfh_status compound_ur_s.putfh_status
272/*
273 * Define simple compound structs that include op specific data
274 */
275typedef struct getattrres_cmn {
276	uint_t		gc_opgetattr;		/* getattr opnum */
277	nfsstat4	gc_attr_status;		/* getattr result */
278	b_bitmap4_t	gc_retattr;		/* getattr result */
279	uint_t		gc_attrlist_len;	/* getattr result */
280	b_fattr4_t	gc_attrs;		/* getattr result */
281} getattrres_cmn_t;
282
283/*
284 * getattr: putfh/getattr
285 */
286typedef struct getattr4arg_s {
287	b_compound_t	ga_arg;		/* compound + putfh */
288	uint_t		ga_opgetattr;	/* getattr opnum */
289	b_bitmap4_t	ga_attr_req;	/* getattr arg */
290} getattr4arg_t;
291
292typedef struct getattr4res_s {
293	b_compound_t		gr_res;	/* compound + putfh */
294	getattrres_cmn_t	gr_cmn;
295} getattr4res_t;
296
297#define	gr_opgetattr gr_cmn.gc_opgetattr
298#define	gr_attr_status gr_cmn.gc_attr_status
299#define	gr_retattr gr_cmn.gc_retattr
300#define	gr_attrs gr_cmn.gc_attrs
301
302/*
303 * lookup: putfh/lookup/getattr
304 */
305typedef struct lookup4arg_s {
306	b_compound_t	la_arg;		/* compound + putfh */
307	uint_t		la_oplookup;	/* lookup opnum */
308	component4	la_pathname;	/* lookup arg */
309	uint_t		la_opgetattr;	/* getattr opnum */
310	b_bitmap4_t	la_attr_req;	/* getattr arg */
311} lookup4arg_t;
312
313typedef struct lookup4res_s {
314	b_compound_t		lr_res;		/* compound + putfh */
315	uint_t			lr_oplookup;	/* lookup opnum */
316	nfsstat4		lr_lookup_status;	/* lookup result */
317	getattrres_cmn_t	lr_gcmn;	/* getattr result */
318} lookup4res_t;
319
320#define	lr_opgetattr lr_gcmn.gc_opgetattr
321#define	lr_attr_status lr_gcmn.gc_attr_status
322#define	lr_retattr lr_gcmn.gc_retattr
323#define	lr_attrs lr_gcmn.gc_attrs
324
325/*
326 * lookupp: putfh/lookupp/getattr
327 *
328 * For results: use the lookup4res_t
329 */
330typedef struct lookupp4arg_s {
331	b_compound_t	la_arg;		/* compound + putfh */
332	uint_t		la_oplookupp;	/* lookupp opnum */
333	uint_t		la_opgetattr;	/* lookupp arg */
334	b_bitmap4_t	la_attr_req;	/* lookupp arg */
335} lookupp4arg_t;
336
337/*
338 * read: putfh/read
339 */
340typedef struct read4arg_s {
341	b_compound_t	r_arg;		/* compound + putfh */
342	uint_t		r_opread;	/* read opnum */
343	stateid4	r_stateid;	/* read arg */
344	offset4		r_offset;	/* read arg */
345	count4		r_count;	/* read arg */
346} read4arg_t;
347
348typedef struct read4res_s {
349	b_compound_t	r_res;		/* compound + putfh */
350	uint_t		r_opread;	/* read opnum */
351	nfsstat4	r_status;	/* read result */
352	bool_t		r_eof;		/* read result */
353	uint_t		r_data_len;	/* read result */
354	char		*r_data_val;	/* read result */
355} read4res_t;
356
357typedef struct b_entry4_s {
358	nfs_cookie4		b_cookie;
359	utf8string		b_name;
360	uint64_t		b_fileid;
361	struct b_entry4_s	*b_nextentry;
362} b_entry4_t;
363
364/*
365 * readdir: putfh/readdir/getattr
366 */
367typedef struct readdir4arg_s {
368	b_compound_t	rd_arg;		/* compoud + putfh */
369	uint_t		rd_opreaddir;	/* readdir opnum */
370	nfs_cookie4	rd_cookie;	/* readdir arg */
371	verifier4	rd_cookieverf;	/* readdir arg */
372	count4		rd_dircount;	/* readdir arg */
373	count4		rd_maxcount;	/* readdir arg */
374	b_bitmap4_t	rd_attr_req;	/* readdir arg */
375} readdir4arg_t;
376
377typedef struct readdir4res_s {
378	b_compound_t	rd_res;		/* compound + putfh */
379	uint_t		rd_opreaddir;	/* readdir opnum */
380	nfsstat4	rd_status;	/* readdir result */
381	verifier4	rd_cookieverf;	/* readdir result */
382	b_entry4_t	*rd_entries;	/* readdir result */
383	bool_t		rd_eof;		/* readdir result */
384} readdir4res_t;
385
386/*
387 * readlink: putfh/readlink
388 */
389typedef struct readlink4arg_s {
390	b_compound_t	rl_arg;		/* compound + putfh */
391	uint_t		rl_opreadlink;	/* readlink opnum */
392} readlink4arg_t;
393
394typedef struct readlink4res_s {
395	b_compound_t	rl_res;		/* compound + putfh */
396	uint_t		rl_opreadlink;	/* readlink opnum */
397	nfsstat4	rl_status;	/* readlink result */
398	utf8string	rl_link;	/* readlink result */
399} readlink4res_t;
400
401/*
402 * Generic NFS functions
403 */
404extern int	boot_nfs_mountroot(char *);
405extern int	boot_nfs_unmountroot(void);
406extern int	lookup(char *pathname, struct nfs_file *, bool_t);
407extern bool_t	whoami(void);
408extern bool_t	getfile(char *, char *, struct in_addr *, char *);
409
410/*
411 * NFS Version 2 specific functions
412 */
413extern void	nfs_error(enum nfsstat);
414extern ssize_t	nfsread(struct nfs_file *, char *, size_t);
415extern int	nfsgetattr(struct nfs_file *, struct vattr *);
416extern int	nfsgetdents(struct nfs_file *, struct dirent *, unsigned);
417extern struct nfs_file *nfslookup(struct nfs_file *, char *, int *);
418extern int nfsgetsymlink(struct nfs_file *cfile, char **path);
419
420/*
421 * NFS Version 3 specific functions
422 */
423extern void	nfs3_error(enum nfsstat3);
424extern ssize_t	nfs3read(struct nfs_file *, char *, size_t);
425extern int	nfs3getattr(struct nfs_file *, struct vattr *);
426extern int	nfs3getdents(struct nfs_file *, struct dirent *, unsigned);
427extern struct nfs_file *nfs3lookup(struct nfs_file *, char *, int *);
428extern int	nfs3getsymlink(struct nfs_file *, char **);
429
430/*
431 * NFS Version 4 specific functions
432 */
433extern void	nfs4_error(enum nfsstat4);
434extern ssize_t	nfs4read(struct nfs_file *, char *, size_t);
435extern int	nfs4getattr(struct nfs_file *, struct vattr *);
436extern int	nfs4_getdents(struct nfs_file *, struct dirent *, unsigned);
437extern struct nfs_file *nfs4lookup(struct nfs_file *, char *, int *);
438extern struct nfs_file *nfs4lookupp(struct nfs_file *, int *, uint64_t *);
439extern int	nfs4getsymlink(struct nfs_file *, char **);
440extern void	compound_init(b_compound_t *, utf8string *, uint_t, uint_t,
441				struct nfs_bfh4 *);
442
443/*
444 * NFSv4 xdr ops
445 */
446extern bool_t	xdr_getattr4_args(XDR *, getattr4arg_t *);
447extern bool_t	xdr_getattr4_res(XDR *, getattr4res_t *);
448extern bool_t	xdr_lookup4_args(XDR *, lookup4arg_t *);
449extern bool_t	xdr_lookup4_res(XDR *, lookup4res_t *);
450extern bool_t	xdr_lookupp4_args(XDR *, lookupp4arg_t *);
451extern bool_t	xdr_read4_args(XDR *, read4arg_t *);
452extern bool_t	xdr_read4_res(XDR *, read4res_t *);
453extern bool_t	xdr_readdir4_args(XDR *, readdir4arg_t *);
454extern bool_t	xdr_readdir4_res(XDR *, readdir4res_t *);
455extern bool_t	xdr_readlink4_args(XDR *, readlink4arg_t *);
456extern bool_t	xdr_readlink4_res(XDR *, readlink4res_t *);
457
458#ifdef	__cplusplus
459}
460#endif
461
462#endif /* _NFS_INET_H */
463