1 2277c5d7 2004-03-21 devnull #ifndef __9P_H__
  2 2277c5d7 2004-03-21 devnull #define __9P_H__ 1
  3 2277c5d7 2004-03-21 devnull 
  4 2277c5d7 2004-03-21 devnull #ifdef __cplusplus
  5 2277c5d7 2004-03-21 devnull extern "C" {
  6 2277c5d7 2004-03-21 devnull #endif
  7 2277c5d7 2004-03-21 devnull 
  8 2277c5d7 2004-03-21 devnull /*
  9 2277c5d7 2004-03-21 devnull #pragma src "/sys/src/lib9p"
 10 2277c5d7 2004-03-21 devnull #pragma lib "lib9p.a"
 11 2277c5d7 2004-03-21 devnull */
 12 2277c5d7 2004-03-21 devnull 
 13 2277c5d7 2004-03-21 devnull /*
 14 2277c5d7 2004-03-21 devnull  * Maps from ulongs to void*s.
 15 2277c5d7 2004-03-21 devnull  */
 16 2277c5d7 2004-03-21 devnull typedef struct Intmap	Intmap;
 17 2277c5d7 2004-03-21 devnull 
 18 2277c5d7 2004-03-21 devnull Intmap*	allocmap(void (*inc)(void*));
 19 2277c5d7 2004-03-21 devnull void		freemap(Intmap*, void (*destroy)(void*));
 20 2277c5d7 2004-03-21 devnull void*	lookupkey(Intmap*, ulong);
 21 2277c5d7 2004-03-21 devnull void*	insertkey(Intmap*, ulong, void*);
 22 2277c5d7 2004-03-21 devnull int		caninsertkey(Intmap*, ulong, void*);
 23 2277c5d7 2004-03-21 devnull void*	deletekey(Intmap*, ulong);
 24 2277c5d7 2004-03-21 devnull 
 25 2277c5d7 2004-03-21 devnull /*
 26 2277c5d7 2004-03-21 devnull  * Fid and Request structures.
 27 2277c5d7 2004-03-21 devnull  */
 28 2277c5d7 2004-03-21 devnull typedef struct Fid		Fid;
 29 2277c5d7 2004-03-21 devnull typedef struct Req		Req;
 30 2277c5d7 2004-03-21 devnull typedef struct Fidpool	Fidpool;
 31 2277c5d7 2004-03-21 devnull typedef struct Reqpool	Reqpool;
 32 2277c5d7 2004-03-21 devnull typedef struct File		File;
 33 2277c5d7 2004-03-21 devnull typedef struct Filelist	Filelist;
 34 2277c5d7 2004-03-21 devnull typedef struct Tree		Tree;
 35 2277c5d7 2004-03-21 devnull typedef struct Readdir	Readdir;
 36 2277c5d7 2004-03-21 devnull typedef struct Srv Srv;
 37 2277c5d7 2004-03-21 devnull 
 38 2277c5d7 2004-03-21 devnull struct Fid
 39 2277c5d7 2004-03-21 devnull {
 40 2277c5d7 2004-03-21 devnull 	ulong	fid;
 41 2277c5d7 2004-03-21 devnull 	char		omode;	/* -1 = not open */
 42 2277c5d7 2004-03-21 devnull 	File*		file;
 43 2277c5d7 2004-03-21 devnull 	char*	uid;
 44 2277c5d7 2004-03-21 devnull 	Qid		qid;
 45 2277c5d7 2004-03-21 devnull 	void*	aux;
 46 2277c5d7 2004-03-21 devnull 
 47 2277c5d7 2004-03-21 devnull /* below is implementation-specific; don't use */
 48 2277c5d7 2004-03-21 devnull 	Readdir*	rdir;
 49 2277c5d7 2004-03-21 devnull 	Ref		ref;
 50 2277c5d7 2004-03-21 devnull 	Fidpool*	pool;
 51 2277c5d7 2004-03-21 devnull 	vlong	diroffset;
 52 2277c5d7 2004-03-21 devnull 	long		dirindex;
 53 2277c5d7 2004-03-21 devnull };
 54 2277c5d7 2004-03-21 devnull 
 55 2277c5d7 2004-03-21 devnull struct Req
 56 2277c5d7 2004-03-21 devnull {
 57 2277c5d7 2004-03-21 devnull 	ulong	tag;
 58 2277c5d7 2004-03-21 devnull 	void*	aux;
 59 2277c5d7 2004-03-21 devnull 	Fcall		ifcall;
 60 2277c5d7 2004-03-21 devnull 	Fcall		ofcall;
 61 2277c5d7 2004-03-21 devnull 	Dir		d;
 62 2277c5d7 2004-03-21 devnull 	Req*		oldreq;
 63 2277c5d7 2004-03-21 devnull 	Fid*		fid;
 64 2277c5d7 2004-03-21 devnull 	Fid*		afid;
 65 2277c5d7 2004-03-21 devnull 	Fid*		newfid;
 66 2277c5d7 2004-03-21 devnull 	Srv*		srv;
 67 2277c5d7 2004-03-21 devnull 
 68 2277c5d7 2004-03-21 devnull /* below is implementation-specific; don't use */
 69 2277c5d7 2004-03-21 devnull 	QLock	lk;
 70 2277c5d7 2004-03-21 devnull 	Ref		ref;
 71 2277c5d7 2004-03-21 devnull 	Reqpool*	pool;
 72 2277c5d7 2004-03-21 devnull 	uchar*	buf;
 73 2277c5d7 2004-03-21 devnull 	uchar	type;
 74 2277c5d7 2004-03-21 devnull 	uchar	responded;
 75 2277c5d7 2004-03-21 devnull 	char*	error;
 76 2277c5d7 2004-03-21 devnull 	void*	rbuf;
 77 2277c5d7 2004-03-21 devnull 	Req**	flush;
 78 2277c5d7 2004-03-21 devnull 	int		nflush;
 79 2277c5d7 2004-03-21 devnull };
 80 2277c5d7 2004-03-21 devnull 
 81 2277c5d7 2004-03-21 devnull /*
 82 2277c5d7 2004-03-21 devnull  * Pools to maintain Fid <-> fid and Req <-> tag maps.
 83 2277c5d7 2004-03-21 devnull  */
 84 2277c5d7 2004-03-21 devnull 
 85 2277c5d7 2004-03-21 devnull struct Fidpool {
 86 2277c5d7 2004-03-21 devnull 	Intmap	*map;
 87 2277c5d7 2004-03-21 devnull 	void		(*destroy)(Fid*);
 88 2277c5d7 2004-03-21 devnull 	Srv		*srv;
 89 2277c5d7 2004-03-21 devnull };
 90 2277c5d7 2004-03-21 devnull 
 91 2277c5d7 2004-03-21 devnull struct Reqpool {
 92 2277c5d7 2004-03-21 devnull 	Intmap	*map;
 93 2277c5d7 2004-03-21 devnull 	void		(*destroy)(Req*);
 94 2277c5d7 2004-03-21 devnull 	Srv		*srv;
 95 2277c5d7 2004-03-21 devnull };
 96 2277c5d7 2004-03-21 devnull 
 97 2277c5d7 2004-03-21 devnull Fidpool*	allocfidpool(void (*destroy)(Fid*));
 98 2277c5d7 2004-03-21 devnull void		freefidpool(Fidpool*);
 99 2277c5d7 2004-03-21 devnull Fid*		allocfid(Fidpool*, ulong);
100 2277c5d7 2004-03-21 devnull Fid*		lookupfid(Fidpool*, ulong);
101 2277c5d7 2004-03-21 devnull void		closefid(Fid*);
102 2277c5d7 2004-03-21 devnull Fid*		removefid(Fidpool*, ulong);
103 2277c5d7 2004-03-21 devnull 
104 2277c5d7 2004-03-21 devnull Reqpool*	allocreqpool(void (*destroy)(Req*));
105 2277c5d7 2004-03-21 devnull void		freereqpool(Reqpool*);
106 2277c5d7 2004-03-21 devnull Req*		allocreq(Reqpool*, ulong);
107 2277c5d7 2004-03-21 devnull Req*		lookupreq(Reqpool*, ulong);
108 2277c5d7 2004-03-21 devnull void		closereq(Req*);
109 2277c5d7 2004-03-21 devnull Req*		removereq(Reqpool*, ulong);
110 2277c5d7 2004-03-21 devnull 
111 2277c5d7 2004-03-21 devnull typedef	int	Dirgen(int, Dir*, void*);
112 2277c5d7 2004-03-21 devnull void		dirread9p(Req*, Dirgen*, void*);
113 2277c5d7 2004-03-21 devnull 
114 2277c5d7 2004-03-21 devnull /*
115 2277c5d7 2004-03-21 devnull  * File trees.
116 2277c5d7 2004-03-21 devnull  */
117 2277c5d7 2004-03-21 devnull struct File {
118 2277c5d7 2004-03-21 devnull 	Ref ref;
119 2277c5d7 2004-03-21 devnull 	Dir dir;
120 2277c5d7 2004-03-21 devnull 	File *parent;
121 2277c5d7 2004-03-21 devnull 	void *aux;
122 2277c5d7 2004-03-21 devnull 
123 2277c5d7 2004-03-21 devnull /* below is implementation-specific; don't use */
124 2277c5d7 2004-03-21 devnull 	RWLock rwlock;
125 2277c5d7 2004-03-21 devnull 	Filelist *filelist;
126 2277c5d7 2004-03-21 devnull 	Tree *tree;
127 2277c5d7 2004-03-21 devnull 	int nchild;
128 2277c5d7 2004-03-21 devnull 	int allocd;
129 2277c5d7 2004-03-21 devnull };
130 2277c5d7 2004-03-21 devnull 
131 2277c5d7 2004-03-21 devnull struct Tree {
132 2277c5d7 2004-03-21 devnull 	File *root;
133 2277c5d7 2004-03-21 devnull 	void	(*destroy)(File *file);
134 2277c5d7 2004-03-21 devnull 
135 2277c5d7 2004-03-21 devnull /* below is implementation-specific; don't use */
136 2277c5d7 2004-03-21 devnull 	Lock genlock;
137 2277c5d7 2004-03-21 devnull 	ulong qidgen;
138 2277c5d7 2004-03-21 devnull 	ulong dirqidgen;
139 2277c5d7 2004-03-21 devnull };
140 2277c5d7 2004-03-21 devnull 
141 2277c5d7 2004-03-21 devnull Tree*	alloctree(char*, char*, ulong, void(*destroy)(File*));
142 2277c5d7 2004-03-21 devnull void		freetree(Tree*);
143 2277c5d7 2004-03-21 devnull File*		createfile(File*, char*, char*, ulong, void*);
144 2277c5d7 2004-03-21 devnull int		removefile(File*);
145 2277c5d7 2004-03-21 devnull void		closefile(File*);
146 2277c5d7 2004-03-21 devnull File*		walkfile(File*, char*);
147 2277c5d7 2004-03-21 devnull Readdir*	opendirfile(File*);
148 2277c5d7 2004-03-21 devnull long		readdirfile(Readdir*, uchar*, long);
149 2277c5d7 2004-03-21 devnull void		closedirfile(Readdir*);
150 2277c5d7 2004-03-21 devnull 
151 2277c5d7 2004-03-21 devnull /*
152 2277c5d7 2004-03-21 devnull  * Kernel-style command parser
153 2277c5d7 2004-03-21 devnull  */
154 2277c5d7 2004-03-21 devnull typedef struct Cmdbuf Cmdbuf;
155 2277c5d7 2004-03-21 devnull typedef struct Cmdtab Cmdtab;
156 2277c5d7 2004-03-21 devnull Cmdbuf*		parsecmd(char *a, int n);
157 2277c5d7 2004-03-21 devnull void		respondcmderror(Req*, Cmdbuf*, char*, ...);
158 2277c5d7 2004-03-21 devnull Cmdtab*	lookupcmd(Cmdbuf*, Cmdtab*, int);
159 2277c5d7 2004-03-21 devnull /*
160 2277c5d7 2004-03-21 devnull #pragma varargck argpos respondcmderr 3
161 2277c5d7 2004-03-21 devnull */
162 2277c5d7 2004-03-21 devnull struct Cmdbuf
163 2277c5d7 2004-03-21 devnull {
164 2277c5d7 2004-03-21 devnull 	char	*buf;
165 2277c5d7 2004-03-21 devnull 	char	**f;
166 2277c5d7 2004-03-21 devnull 	int	nf;
167 2277c5d7 2004-03-21 devnull };
168 2277c5d7 2004-03-21 devnull 
169 2277c5d7 2004-03-21 devnull struct Cmdtab
170 2277c5d7 2004-03-21 devnull {
171 2277c5d7 2004-03-21 devnull 	int	index;	/* used by client to switch on result */
172 2277c5d7 2004-03-21 devnull 	char	*cmd;	/* command name */
173 2277c5d7 2004-03-21 devnull 	int	narg;	/* expected #args; 0 ==> variadic */
174 2277c5d7 2004-03-21 devnull };
175 2277c5d7 2004-03-21 devnull 
176 2277c5d7 2004-03-21 devnull /*
177 2277c5d7 2004-03-21 devnull  * File service loop.
178 2277c5d7 2004-03-21 devnull  */
179 2277c5d7 2004-03-21 devnull struct Srv {
180 2277c5d7 2004-03-21 devnull 	Tree*	tree;
181 2277c5d7 2004-03-21 devnull 	void		(*destroyfid)(Fid*);
182 2277c5d7 2004-03-21 devnull 	void		(*destroyreq)(Req*);
183 2277c5d7 2004-03-21 devnull 	void		(*end)(Srv*);
184 2277c5d7 2004-03-21 devnull 	void*	aux;
185 2277c5d7 2004-03-21 devnull 
186 2277c5d7 2004-03-21 devnull 	void		(*attach)(Req*);
187 2277c5d7 2004-03-21 devnull 	void		(*auth)(Req*);
188 2277c5d7 2004-03-21 devnull 	void		(*open)(Req*);
189 2277c5d7 2004-03-21 devnull 	void		(*create)(Req*);
190 2277c5d7 2004-03-21 devnull 	void		(*read)(Req*);
191 2277c5d7 2004-03-21 devnull 	void		(*write)(Req*);
192 2277c5d7 2004-03-21 devnull 	void		(*remove)(Req*);
193 2277c5d7 2004-03-21 devnull 	void		(*flush)(Req*);
194 2277c5d7 2004-03-21 devnull 	void		(*stat)(Req*);
195 2277c5d7 2004-03-21 devnull 	void		(*wstat)(Req*);
196 2277c5d7 2004-03-21 devnull 	void		(*walk)(Req*);
197 2277c5d7 2004-03-21 devnull 	char*	(*clone)(Fid*, Fid*);
198 2277c5d7 2004-03-21 devnull 	char*	(*walk1)(Fid*, char*, Qid*);
199 2277c5d7 2004-03-21 devnull 
200 2277c5d7 2004-03-21 devnull 	int		infd;
201 2277c5d7 2004-03-21 devnull 	int		outfd;
202 2277c5d7 2004-03-21 devnull 	int		nopipe;
203 2277c5d7 2004-03-21 devnull 	int		srvfd;
204 2277c5d7 2004-03-21 devnull 	int		leavefdsopen;	/* magic for acme win */
205 2277c5d7 2004-03-21 devnull 
206 2277c5d7 2004-03-21 devnull /* below is implementation-specific; don't use */
207 2277c5d7 2004-03-21 devnull 	Fidpool*	fpool;
208 2277c5d7 2004-03-21 devnull 	Reqpool*	rpool;
209 2277c5d7 2004-03-21 devnull 	uint		msize;
210 2277c5d7 2004-03-21 devnull 
211 2277c5d7 2004-03-21 devnull 	uchar*	rbuf;
212 2277c5d7 2004-03-21 devnull 	QLock	rlock;
213 2277c5d7 2004-03-21 devnull 	uchar*	wbuf;
214 2277c5d7 2004-03-21 devnull 	QLock	wlock;
215 2277c5d7 2004-03-21 devnull };
216 2277c5d7 2004-03-21 devnull 
217 2277c5d7 2004-03-21 devnull void		srv(Srv*);
218 2277c5d7 2004-03-21 devnull void		postmountsrv(Srv*, char*, char*, int);
219 2277c5d7 2004-03-21 devnull int 		postfd(char*, int);
220 2277c5d7 2004-03-21 devnull int		chatty9p;
221 2277c5d7 2004-03-21 devnull void		respond(Req*, char*);
222 2277c5d7 2004-03-21 devnull void		threadpostmountsrv(Srv*, char*, char*, int);
223 2277c5d7 2004-03-21 devnull 
224 2277c5d7 2004-03-21 devnull /*
225 2277c5d7 2004-03-21 devnull  * Helper.  Assumes user is same as group.
226 2277c5d7 2004-03-21 devnull  */
227 2277c5d7 2004-03-21 devnull int		hasperm(File*, char*, int);
228 2277c5d7 2004-03-21 devnull 
229 2277c5d7 2004-03-21 devnull void*	emalloc9p(ulong);
230 2277c5d7 2004-03-21 devnull void*	erealloc9p(void*, ulong);
231 2277c5d7 2004-03-21 devnull char*	estrdup9p(char*);
232 2277c5d7 2004-03-21 devnull 
233 2277c5d7 2004-03-21 devnull enum {
234 2277c5d7 2004-03-21 devnull 	OMASK = 3
235 2277c5d7 2004-03-21 devnull };
236 2277c5d7 2004-03-21 devnull 
237 2277c5d7 2004-03-21 devnull void readstr(Req*, char*);
238 2277c5d7 2004-03-21 devnull void readbuf(Req*, void*, long);
239 2277c5d7 2004-03-21 devnull void	walkandclone(Req*, char*(*walk1)(Fid*,char*,void*), char*(*clone)(Fid*,Fid*,void*), void*);
240 2277c5d7 2004-03-21 devnull 
241 2277c5d7 2004-03-21 devnull #ifdef __cplusplus
242 2277c5d7 2004-03-21 devnull }
243 2277c5d7 2004-03-21 devnull #endif
244 2277c5d7 2004-03-21 devnull #endif