]> bbs.cooldavid.org Git - net-next-2.6.git/blame - include/net/9p/9p.h
9p: attach-per-user
[net-next-2.6.git] / include / net / 9p / 9p.h
CommitLineData
bd238fb4
LI
1/*
2 * include/net/9p/9p.h
3 *
4 * 9P protocol definitions.
5 *
6 * Copyright (C) 2005 by Latchesar Ionkov <lucho@ionkov.net>
7 * Copyright (C) 2004 by Eric Van Hensbergen <ericvh@gmail.com>
8 * Copyright (C) 2002 by Ron Minnich <rminnich@lanl.gov>
9 *
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License version 2
12 * as published by the Free Software Foundation.
13 *
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
18 *
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to:
21 * Free Software Foundation
22 * 51 Franklin Street, Fifth Floor
23 * Boston, MA 02111-1301 USA
24 *
25 */
26
27#ifndef NET_9P_H
28#define NET_9P_H
29
30#ifdef CONFIG_NET_9P_DEBUG
31
32#define P9_DEBUG_ERROR (1<<0)
33#define P9_DEBUG_9P (1<<2)
34#define P9_DEBUG_VFS (1<<3)
35#define P9_DEBUG_CONV (1<<4)
36#define P9_DEBUG_MUX (1<<5)
37#define P9_DEBUG_TRANS (1<<6)
38#define P9_DEBUG_SLABS (1<<7)
39#define P9_DEBUG_FCALL (1<<8)
40
41extern unsigned int p9_debug_level;
42
43#define P9_DPRINTK(level, format, arg...) \
44do { \
45 if ((p9_debug_level & level) == level) \
46 printk(KERN_NOTICE "-- %s (%d): " \
47 format , __FUNCTION__, current->pid , ## arg); \
48} while (0)
49
50#define PRINT_FCALL_ERROR(s, fcall) P9_DPRINTK(P9_DEBUG_ERROR, \
51 "%s: %.*s\n", s, fcall?fcall->params.rerror.error.len:0, \
52 fcall?fcall->params.rerror.error.str:"");
53
54#else
55#define P9_DPRINTK(level, format, arg...) do { } while (0)
56#define PRINT_FCALL_ERROR(s, fcall) do { } while (0)
57#endif
58
59#define P9_EPRINTK(level, format, arg...) \
60do { \
61 printk(level "9p: %s (%d): " \
62 format , __FUNCTION__, current->pid , ## arg); \
63} while (0)
64
65
66/* Message Types */
67enum {
68 P9_TVERSION = 100,
69 P9_RVERSION,
70 P9_TAUTH = 102,
71 P9_RAUTH,
72 P9_TATTACH = 104,
73 P9_RATTACH,
74 P9_TERROR = 106,
75 P9_RERROR,
76 P9_TFLUSH = 108,
77 P9_RFLUSH,
78 P9_TWALK = 110,
79 P9_RWALK,
80 P9_TOPEN = 112,
81 P9_ROPEN,
82 P9_TCREATE = 114,
83 P9_RCREATE,
84 P9_TREAD = 116,
85 P9_RREAD,
86 P9_TWRITE = 118,
87 P9_RWRITE,
88 P9_TCLUNK = 120,
89 P9_RCLUNK,
90 P9_TREMOVE = 122,
91 P9_RREMOVE,
92 P9_TSTAT = 124,
93 P9_RSTAT,
94 P9_TWSTAT = 126,
95 P9_RWSTAT,
96};
97
98/* open modes */
99enum {
100 P9_OREAD = 0x00,
101 P9_OWRITE = 0x01,
102 P9_ORDWR = 0x02,
103 P9_OEXEC = 0x03,
104 P9_OEXCL = 0x04,
105 P9_OTRUNC = 0x10,
106 P9_OREXEC = 0x20,
107 P9_ORCLOSE = 0x40,
108 P9_OAPPEND = 0x80,
109};
110
111/* permissions */
112enum {
113 P9_DMDIR = 0x80000000,
114 P9_DMAPPEND = 0x40000000,
115 P9_DMEXCL = 0x20000000,
116 P9_DMMOUNT = 0x10000000,
117 P9_DMAUTH = 0x08000000,
118 P9_DMTMP = 0x04000000,
119 P9_DMSYMLINK = 0x02000000,
120 P9_DMLINK = 0x01000000,
121 /* 9P2000.u extensions */
122 P9_DMDEVICE = 0x00800000,
123 P9_DMNAMEDPIPE = 0x00200000,
124 P9_DMSOCKET = 0x00100000,
125 P9_DMSETUID = 0x00080000,
126 P9_DMSETGID = 0x00040000,
127};
128
129/* qid.types */
130enum {
131 P9_QTDIR = 0x80,
132 P9_QTAPPEND = 0x40,
133 P9_QTEXCL = 0x20,
134 P9_QTMOUNT = 0x10,
135 P9_QTAUTH = 0x08,
136 P9_QTTMP = 0x04,
137 P9_QTSYMLINK = 0x02,
138 P9_QTLINK = 0x01,
139 P9_QTFILE = 0x00,
140};
141
142#define P9_NOTAG (u16)(~0)
143#define P9_NOFID (u32)(~0)
144#define P9_MAXWELEM 16
145
146/* ample room for Twrite/Rread header */
147#define P9_IOHDRSZ 24
148
149struct p9_str {
150 u16 len;
151 char *str;
152};
153
154/* qids are the unique ID for a file (like an inode */
155struct p9_qid {
156 u8 type;
157 u32 version;
158 u64 path;
159};
160
161/* Plan 9 file metadata (stat) structure */
162struct p9_stat {
163 u16 size;
164 u16 type;
165 u32 dev;
166 struct p9_qid qid;
167 u32 mode;
168 u32 atime;
169 u32 mtime;
170 u64 length;
171 struct p9_str name;
172 struct p9_str uid;
173 struct p9_str gid;
174 struct p9_str muid;
175 struct p9_str extension; /* 9p2000.u extensions */
176 u32 n_uid; /* 9p2000.u extensions */
177 u32 n_gid; /* 9p2000.u extensions */
178 u32 n_muid; /* 9p2000.u extensions */
179};
180
181/* file metadata (stat) structure used to create Twstat message
182 The is similar to p9_stat, but the strings don't point to
183 the same memory block and should be freed separately
184*/
185struct p9_wstat {
186 u16 size;
187 u16 type;
188 u32 dev;
189 struct p9_qid qid;
190 u32 mode;
191 u32 atime;
192 u32 mtime;
193 u64 length;
194 char *name;
195 char *uid;
196 char *gid;
197 char *muid;
198 char *extension; /* 9p2000.u extensions */
199 u32 n_uid; /* 9p2000.u extensions */
200 u32 n_gid; /* 9p2000.u extensions */
201 u32 n_muid; /* 9p2000.u extensions */
202};
203
204/* Structures for Protocol Operations */
205struct p9_tversion {
206 u32 msize;
207 struct p9_str version;
208};
209
210struct p9_rversion {
211 u32 msize;
212 struct p9_str version;
213};
214
215struct p9_tauth {
216 u32 afid;
217 struct p9_str uname;
218 struct p9_str aname;
ba17674f 219 u32 n_uname; /* 9P2000.u extensions */
bd238fb4
LI
220};
221
222struct p9_rauth {
223 struct p9_qid qid;
224};
225
226struct p9_rerror {
227 struct p9_str error;
228 u32 errno; /* 9p2000.u extension */
229};
230
231struct p9_tflush {
232 u16 oldtag;
233};
234
235struct p9_rflush {
236};
237
238struct p9_tattach {
239 u32 fid;
240 u32 afid;
241 struct p9_str uname;
242 struct p9_str aname;
ba17674f 243 u32 n_uname; /* 9P2000.u extensions */
bd238fb4
LI
244};
245
246struct p9_rattach {
247 struct p9_qid qid;
248};
249
250struct p9_twalk {
251 u32 fid;
252 u32 newfid;
253 u16 nwname;
254 struct p9_str wnames[16];
255};
256
257struct p9_rwalk {
258 u16 nwqid;
259 struct p9_qid wqids[16];
260};
261
262struct p9_topen {
263 u32 fid;
264 u8 mode;
265};
266
267struct p9_ropen {
268 struct p9_qid qid;
269 u32 iounit;
270};
271
272struct p9_tcreate {
273 u32 fid;
274 struct p9_str name;
275 u32 perm;
276 u8 mode;
277 struct p9_str extension;
278};
279
280struct p9_rcreate {
281 struct p9_qid qid;
282 u32 iounit;
283};
284
285struct p9_tread {
286 u32 fid;
287 u64 offset;
288 u32 count;
289};
290
291struct p9_rread {
292 u32 count;
293 u8 *data;
294};
295
296struct p9_twrite {
297 u32 fid;
298 u64 offset;
299 u32 count;
300 u8 *data;
301};
302
303struct p9_rwrite {
304 u32 count;
305};
306
307struct p9_tclunk {
308 u32 fid;
309};
310
311struct p9_rclunk {
312};
313
314struct p9_tremove {
315 u32 fid;
316};
317
318struct p9_rremove {
319};
320
321struct p9_tstat {
322 u32 fid;
323};
324
325struct p9_rstat {
326 struct p9_stat stat;
327};
328
329struct p9_twstat {
330 u32 fid;
331 struct p9_stat stat;
332};
333
334struct p9_rwstat {
335};
336
337/*
338 * fcall is the primary packet structure
339 *
340 */
341
342struct p9_fcall {
343 u32 size;
344 u8 id;
345 u16 tag;
346 void *sdata;
347
348 union {
349 struct p9_tversion tversion;
350 struct p9_rversion rversion;
351 struct p9_tauth tauth;
352 struct p9_rauth rauth;
353 struct p9_rerror rerror;
354 struct p9_tflush tflush;
355 struct p9_rflush rflush;
356 struct p9_tattach tattach;
357 struct p9_rattach rattach;
358 struct p9_twalk twalk;
359 struct p9_rwalk rwalk;
360 struct p9_topen topen;
361 struct p9_ropen ropen;
362 struct p9_tcreate tcreate;
363 struct p9_rcreate rcreate;
364 struct p9_tread tread;
365 struct p9_rread rread;
366 struct p9_twrite twrite;
367 struct p9_rwrite rwrite;
368 struct p9_tclunk tclunk;
369 struct p9_rclunk rclunk;
370 struct p9_tremove tremove;
371 struct p9_rremove rremove;
372 struct p9_tstat tstat;
373 struct p9_rstat rstat;
374 struct p9_twstat twstat;
375 struct p9_rwstat rwstat;
376 } params;
377};
378
379struct p9_idpool;
380
381int p9_deserialize_stat(void *buf, u32 buflen, struct p9_stat *stat,
382 int dotu);
383int p9_deserialize_fcall(void *buf, u32 buflen, struct p9_fcall *fc, int dotu);
384void p9_set_tag(struct p9_fcall *fc, u16 tag);
385struct p9_fcall *p9_create_tversion(u32 msize, char *version);
386struct p9_fcall *p9_create_tattach(u32 fid, u32 afid, char *uname,
ba17674f
LI
387 char *aname, u32 n_uname, int dotu);
388struct p9_fcall *p9_create_tauth(u32 afid, char *uname, char *aname,
389 u32 n_uname, int dotu);
bd238fb4
LI
390struct p9_fcall *p9_create_tflush(u16 oldtag);
391struct p9_fcall *p9_create_twalk(u32 fid, u32 newfid, u16 nwname,
392 char **wnames);
393struct p9_fcall *p9_create_topen(u32 fid, u8 mode);
394struct p9_fcall *p9_create_tcreate(u32 fid, char *name, u32 perm, u8 mode,
395 char *extension, int dotu);
396struct p9_fcall *p9_create_tread(u32 fid, u64 offset, u32 count);
397struct p9_fcall *p9_create_twrite(u32 fid, u64 offset, u32 count,
398 const char *data);
399struct p9_fcall *p9_create_twrite_u(u32 fid, u64 offset, u32 count,
400 const char __user *data);
401struct p9_fcall *p9_create_tclunk(u32 fid);
402struct p9_fcall *p9_create_tremove(u32 fid);
403struct p9_fcall *p9_create_tstat(u32 fid);
404struct p9_fcall *p9_create_twstat(u32 fid, struct p9_wstat *wstat,
405 int dotu);
406
407int p9_printfcall(char *buf, int buflen, struct p9_fcall *fc, int dotu);
408int p9_errstr2errno(char *errstr, int len);
409
410struct p9_idpool *p9_idpool_create(void);
411void p9_idpool_destroy(struct p9_idpool *);
412int p9_idpool_get(struct p9_idpool *p);
413void p9_idpool_put(int id, struct p9_idpool *p);
414int p9_idpool_check(int id, struct p9_idpool *p);
415
416int p9_error_init(void);
417int p9_errstr2errno(char *, int);
092e9d93
IM
418
419#ifdef CONFIG_SYSCTL
bd238fb4
LI
420int __init p9_sysctl_register(void);
421void __exit p9_sysctl_unregister(void);
092e9d93
IM
422#else
423static inline int p9_sysctl_register(void)
424{
425 return 0;
426}
427static inline void p9_sysctl_unregister(void)
428{
429}
430#endif
431
bd238fb4 432#endif /* NET_9P_H */