vfs: Move FD management code to 9ns
[akaros.git] / kern / include / ns.h
1 /* Copyright © 1994-1999 Lucent Technologies Inc.  All rights reserved.
2  * Portions Copyright © 1997-1999 Vita Nuova Limited
3  * Portions Copyright © 2000-2007 Vita Nuova Holdings Limited
4  *                                (www.vitanuova.com)
5  * Revisions Copyright © 2000-2007 Lucent Technologies Inc. and others
6  *
7  * Modified for the Akaros operating system:
8  * Copyright (c) 2013-2014 The Regents of the University of California
9  * Copyright (c) 2013-2015 Google Inc.
10  *
11  * Permission is hereby granted, free of charge, to any person obtaining a copy
12  * of this software and associated documentation files (the "Software"), to deal
13  * in the Software without restriction, including without limitation the rights
14  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
15  * copies of the Software, and to permit persons to whom the Software is
16  * furnished to do so, subject to the following conditions:
17  *
18  * The above copyright notice and this permission notice shall be included in
19  * all copies or substantial portions of the Software.
20  *
21  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
22  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
23  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
24  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
25  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
26  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
27  * SOFTWARE. */
28
29
30 #pragma once
31
32 #include <err.h>
33 #include <rendez.h>
34 #include <rwlock.h>
35 #include <linker_func.h>
36 #include <fdtap.h>
37 #include <ros/fs.h>
38 #include <vfs.h>
39
40 /*
41  * functions (possibly) linked in, complete, from libc.
42  */
43 enum {
44         UTFmax = 4,                                     /* maximum bytes per rune */
45         Runesync = 0x80,        /* cannot represent part of a UTF sequence (<) */
46         Runeself = 0x80,        /* rune and UTF sequences are the same (<) */
47         Runeerror = 0xFFFD,     /* decoding error in UTF */
48         Runemax = 0x10FFFF,     /* 21-bit rune */
49         Runemask = 0x1FFFFF,    /* bits used by runes (see grep) */
50         NUMSIZE32 = 10, /* max size of formatted 32 bit number (hex or decimal) */
51         NUMSIZE64 = 20, /* max size of formatted 64 bit number (hex or decimal) */
52 };
53
54 /*
55  * math
56  */
57 extern int isNaN(double);
58 extern int isInf(double, int);
59 extern double floor(double);
60 extern double frexp(double, int *);
61 extern double pow10(int);
62
63 /*
64  * one-of-a-kind
65  */
66 extern char *cleanname(char *unused_char_p_t);
67 //extern    uint32_t    getcallerpc(void*);
68 static inline uint32_t getcallerpc(void *v)
69 {
70         return 0;
71 }
72
73 extern int getfields(char *unused_char_p_t, char **unused_char_pp_t,
74                                          int unused_int, int, char *);
75 extern int tokenize(char *unused_char_p_t, char **unused_char_pp_t, int);
76 extern int dec64(uint8_t * unused_uint8_p_t, int unused_int,
77                                  char *unused_char_p_t, int);
78 extern void qsort(void *, long, long, int (*)(void *, void *));
79
80 extern int toupper(int);
81 extern int myetheraddr(uint8_t * unused_uint8_p_t, char *unused_char_p_t);
82 extern int parseether(uint8_t * unused_uint8_p_t, char *unused_char_p_t);
83
84 /*
85  * network dialling
86  */
87 #define NETPATHLEN      40
88
89 /*
90  * Syscall data structures
91  */
92 #define MORDER  0x0003  /* mask for bits defining order of mounting */
93 #define MREPL   0x0000  /* mount replaces object */
94 #define MBEFORE 0x0001  /* mount goes before others in union directory */
95 #define MAFTER  0x0002  /* mount goes after others in union directory */
96 #define MCREATE 0x0004  /* permit creation in mounted directory */
97 #define MCACHE  0x0010  /* cache some data */
98 #define MMASK   0x0017  /* all bits on */
99
100 #define NCONT   0       /* continue after note */
101 #define NDFLT   1       /* terminate after note */
102 #define NSAVE   2       /* clear note but hold state */
103 #define NRSTR   3       /* restore saved state */
104
105 #define STATMAX 65535U  /* max length of machine-independent stat structure */
106 #define ERRMAX                  128     /* max length of error string */
107 #define KNAMELEN                28      /* max length of name held in kernel */
108
109 /* bits in Qid.type */
110 #define QTDIR           0x80    /* type bit for directories */
111 #define QTAPPEND        0x40    /* type bit for append only files */
112 #define QTEXCL          0x20    /* type bit for exclusive use files */
113 #define QTMOUNT         0x10    /* type bit for mounted channel */
114 #define QTAUTH          0x08    /* type bit for authentication file */
115 #define QTSYMLINK       0x02    /* type bit for symlinks */
116 #define QTFILE          0x01    /* plain file */
117
118 /* bits in Dir.mode */
119 #define DMDIR           0x80000000      /* mode bit for directories */
120 #define DMAPPEND        0x40000000      /* mode bit for append only files */
121 #define DMEXCL          0x20000000      /* mode bit for exclusive use files */
122 #define DMMOUNT         0x10000000      /* mode bit for mounted channel */
123 #define DMWRITABLE      0x08000000      /* non-standard, for select() */
124 #define DMREADABLE      0x04000000      /* non-standard, for select() */
125 #define DMSYMLINK       0x02000000      /* symlink -- from 9p2000.u */
126 #define DMREAD          0x4     /* mode bit for read permission */
127 #define DMWRITE         0x2     /* mode bit for write permission */
128 #define DMEXEC          0x1     /* mode bit for execute permission */
129
130 struct qid {
131         uint64_t path;
132         uint32_t vers;
133         uint8_t type;
134 };
135
136 struct dir {
137         /* system-modified data */
138         uint16_t type;                          /* server type */
139         uint32_t dev;                   /* server subtype */
140         /* file data */
141         struct qid qid;                         /* unique id from server */
142         uint32_t mode;                          /* permissions */
143         /* 9p stat has u32 atime (seconds) here */
144         /* 9p stat has u32 mtime (seconds) here */
145         uint64_t length;                        /* file length: see <u.h> */
146         char *name;                                     /* last element of path */
147         char *uid;                                      /* owner name */
148         char *gid;                                      /* group name */
149         char *muid;                                     /* last modifier name */
150         char *ext;                                      /* extensions for special files (symlinks) */
151         uint32_t n_uid;                         /* numeric owner uid */
152         uint32_t n_gid;                         /* numeric group id */
153         uint32_t n_muid;                        /* numeric last modifier id */
154         struct timespec atime;          /* last access time */
155         struct timespec btime;          /* file creation time */
156         struct timespec ctime;          /* last attribute change time */
157         struct timespec mtime;          /* last data modification time */
158 };
159
160 struct waitmsg {
161         int pid;                                        /* of loved one */
162         uint32_t time[3];                       /* of loved one and descendants */
163         char msg[ERRMAX];                       /* actually variable-size in user mode */
164 };
165
166 #define VERSION9P       "9P2000"
167
168 #define MAXWELEM        16
169
170 typedef
171         struct fcall {
172         uint8_t type;
173         uint32_t fid;
174         uint16_t tag;
175         /* union { */
176         /* struct { */
177         uint32_t msize;                         /* Tversion, Rversion */
178         char *version;                          /* Tversion, Rversion */
179         /* }; */
180         /* struct { */
181         uint16_t oldtag;                        /* Tflush */
182         /* }; */
183         /* struct { */
184         char *ename;                            /* Rerror */
185         /* }; */
186         /* struct { */
187         struct qid qid;                         /* Rattach, Ropen, Rcreate */
188         uint32_t iounit;                        /* Ropen, Rcreate */
189         /* }; */
190         /* struct { */
191         struct qid aqid;                        /* Rauth */
192         /* }; */
193         /* struct { */
194         uint32_t afid;                          /* Tauth, Tattach */
195         char *uname;                            /* Tauth, Tattach */
196         char *aname;                            /* Tauth, Tattach */
197         /* }; */
198         /* struct { */
199         uint32_t perm;                          /* Tcreate */
200         char *name;                                     /* Tcreate */
201         uint8_t mode;                           /* Tcreate, Topen */
202         /* }; */
203         /* struct { */
204         uint32_t newfid;                        /* Twalk */
205         uint16_t nwname;                        /* Twalk */
206         char *wname[MAXWELEM];          /* Twalk */
207         /* }; */
208         /* struct { */
209         uint16_t nwqid;                         /* Rwalk */
210         struct qid wqid[MAXWELEM];      /* Rwalk */
211         /* }; */
212         /* struct { */
213         int64_t offset;                         /* Tread, Twrite */
214         uint32_t count;                         /* Tread, Twrite, Rread */
215         char *data;                                     /* Twrite, Rread */
216         /* }; */
217         /* struct { */
218         uint16_t nstat;                         /* Twstat, Rstat */
219         uint8_t *stat;                          /* Twstat, Rstat */
220         /* }; */
221         /* }; */
222 } fcall;
223
224 #define GBIT8(p)        ((p)[0])
225 #define GBIT16(p)       ((p)[0]|((p)[1]<<8))
226 #define GBIT32(p)       ((uint32_t)((p)[0]|((p)[1]<<8)|((p)[2]<<16)|((p)[3]<<24)))
227 #define GBIT64(p)       ((uint32_t)((p)[0]|((p)[1]<<8)|((p)[2]<<16)|((p)[3]<<24)) |\
228                                 ((int64_t)((p)[4]|((p)[5]<<8)|((p)[6]<<16)|((p)[7]<<24)) << 32))
229
230 #define PBIT8(p,v)      (p)[0]=(v)
231 #define PBIT16(p,v)     (p)[0]=(v);(p)[1]=(v)>>8
232 #define PBIT32(p,v)     (p)[0]=(v);(p)[1]=(v)>>8;(p)[2]=(v)>>16;(p)[3]=(v)>>24
233 #define PBIT64(p,v)     (p)[0]=(v);(p)[1]=(v)>>8;(p)[2]=(v)>>16;(p)[3]=(v)>>24;\
234                         (p)[4]=(v)>>32;(p)[5]=(v)>>40;(p)[6]=(v)>>48;(p)[7]=(v)>>56
235
236 #define BIT8SZ          1
237 #define BIT16SZ         2
238 #define BIT32SZ         4
239 #define BIT64SZ         8
240 #define QIDSZ   (BIT8SZ+BIT32SZ+BIT64SZ)
241
242 /* The 9p STATFIXLENs include the leading 16-bit count.  The count, however,
243  * excludes itself; total size is BIT16SZ + count.  This is the amount of fixed
244  * length data in a stat buffer.  This does not include the strings, but it
245  * includes the string counts (u16s)
246  *
247  * STAT_FIX_LEN_9P is the original 9p stat message: type to length, including
248  * u32 atime and u32 mtime.  This is the bare minimum for a stat that we
249  * receive.  We check in e.g. convM2D for any extra fields.
250  *
251  * STAT_FIX_LEN_AK is the stat message used by Akaros, which includes Eric VH's
252  * extensions and full timespecs.  It is analogous to struct dir, including the
253  * u32s for the legacy atime/mtime.  We always send stats of this size, e.g. in
254  * convD2M.
255  *
256  * Note that the extended stat message has fixed data after the strings, but to
257  * get to this data, you have to jump through the string and their counts
258  * (u16s).  The counts are part of the fixed length, but not the strings.  Also
259  * note that the _AK version has an extra string. */
260 #define STAT_NR_STRINGS_9P 4
261 #define STAT_NR_STRINGS_AK 5
262 #define STAT_FIX_LEN_9P (BIT16SZ +                      /* size */             \
263                          BIT16SZ +                      /* type */             \
264                          BIT32SZ +                      /* dev */              \
265                          QIDSZ +                        /* qid */              \
266                          BIT32SZ +                      /* mode */             \
267                          BIT32SZ +                      /* atime u32 */        \
268                          BIT32SZ +                      /* mtime u32 */        \
269                          BIT64SZ +                      /* length */           \
270                          STAT_NR_STRINGS_9P * BIT16SZ + /* string counts */    \
271                                                  0)
272 #define __STAT_FIX_LEN_AK_NONSTRING (                                          \
273                          BIT32SZ +                      /* n_uid */            \
274                          BIT32SZ +                      /* n_gid */            \
275                          BIT32SZ +                      /* n_muid */           \
276                          2 * BIT64SZ +                  /* atime */            \
277                          2 * BIT64SZ +                  /* btime */            \
278                          2 * BIT64SZ +                  /* ctime */            \
279                          2 * BIT64SZ +                  /* mtime */            \
280                                                  0)
281 #define STAT_FIX_LEN_AK (STAT_FIX_LEN_9P +                                     \
282                          (STAT_NR_STRINGS_AK - STAT_NR_STRINGS_9P) * BIT16SZ + \
283                          __STAT_FIX_LEN_AK_NONSTRING +                         \
284                                                  0)
285
286 #define NOTAG           (uint16_t)~0U   /* Dummy tag */
287 #define NOFID           (uint32_t)~0U   /* Dummy fid */
288 #define IOHDRSZ         24      /* ample room for Twrite/Rread header (iounit) */
289
290 enum {
291         Tversion = 100,
292         Rversion,
293         Tauth = 102,
294         Rauth,
295         Tattach = 104,
296         Rattach,
297         Terror = 106,   /* illegal */
298         Rerror,
299         Tflush = 108,
300         Rflush,
301         Twalk = 110,
302         Rwalk,
303         Topen = 112,
304         Ropen,
305         Tcreate = 114,
306         Rcreate,
307         Tread = 116,
308         Rread,
309         Twrite = 118,
310         Rwrite,
311         Tclunk = 120,
312         Rclunk,
313         Tremove = 122,
314         Rremove,
315         Tstat = 124,
316         Rstat,
317         Twstat = 126,
318         Rwstat,
319         Tmax,
320 };
321
322 void init_empty_dir(struct dir *d);
323 unsigned int convM2S(uint8_t * unused_uint8_p_t, unsigned int unused_int,
324                                          struct fcall *);
325 unsigned int convS2M(struct fcall *, uint8_t * unused_uint8_p_t, unsigned int);
326 unsigned int sizeS2M(struct fcall *);
327
328 unsigned int convM2kdirent(uint8_t * buf, unsigned int nbuf, struct kdirent *kd,
329                                                    char *strs);
330 unsigned int convM2kstat(uint8_t * buf, unsigned int nbuf, struct kstat *ks);
331
332 int statcheck(uint8_t * abuf, unsigned int nbuf);
333 unsigned int convM2D(uint8_t * unused_uint8_p_t, unsigned int unused_int,
334                                          struct dir *, char *unused_char_p_t);
335 unsigned int convD2M(struct dir *, uint8_t * unused_uint8_p_t, unsigned int);
336 unsigned int sizeD2M(struct dir *);
337
338 int read9pmsg(int unused_int, void *, unsigned int);
339
340 struct ref {
341         spinlock_t l;
342         long ref;
343 };
344
345 struct rept {
346         spinlock_t l;
347         struct rendez r;
348         void *o;
349         int t;
350         int (*active) (void *);
351         int (*ck) (void *, int);
352         void (*f) (void *);                     /* called with VM acquire()'d */
353 };
354
355 enum {
356         Nopin = -1
357 };
358
359 struct talarm {
360         spinlock_t lock;
361         struct proc *list;
362 };
363
364 struct alarms {
365         qlock_t qlock;
366         struct proc *head;
367 };
368
369 /*
370  * Access types in namec & channel flags
371  */
372 enum {
373         Aaccess,                                        /* as in stat, wstat */
374         Abind,                                          /* for left-hand-side of bind */
375         Atodir,                                         /* as in chdir */
376         Aopen,                                          /* for i/o */
377         Amount,                                         /* to be mounted or mounted upon */
378         Acreate,                                        /* is to be created */
379         Aremove,                                        /* will be removed by caller */
380
381         /* internal chan flags, used by the kernel only */
382         COPEN =                 0x0001, /* for i/o */
383         CMSG =                  0x0002, /* the message channel for a mount */
384         CFREE =                 0x0004, /* not in use */
385         CCACHE =                0x0008, /* client cache */
386         CINTERNAL_FLAGS = (COPEN | CMSG | CFREE | CCACHE),
387
388         /* chan/file flags, getable via fcntl/getfl and setably via open and
389          * sometimes fcntl/setfl.  those that can't be set cause an error() in
390          * fd_setfl. */
391         CEXTERNAL_FLAGS = (
392             O_CLOEXEC      | /* (prob should be on the FD, 9ns has it here) */
393             O_REMCLO       | /* remove on close (also, maybe should be on FD) */
394             O_APPEND       | /* append on write */
395             O_NONBLOCK     | /* don't block, can't be set via setfl */
396             O_PATH         | /* path open, just the name, no I/O */
397             0),
398 };
399
400 #define NS_IPCK_SHIFT  2
401 #define NS_UDPCK_SHIFT 3
402 #define NS_TCPCK_SHIFT 4
403 #define NS_PKTCK_SHIFT 5
404 #define NS_TSO_SHIFT 6
405 #define NS_SHIFT_MAX 6
406
407 enum {
408         BFREE = (1 << 1),
409         Bipck = (1 << NS_IPCK_SHIFT),   /* ip checksum (rx) */
410         Budpck = (1 << NS_UDPCK_SHIFT), /* udp checksum (rx), needed (tx) */
411         Btcpck = (1 << NS_TCPCK_SHIFT), /* tcp checksum (rx), needed (tx) */
412         Bpktck = (1 << NS_PKTCK_SHIFT), /* packet checksum (rx, maybe) */
413         Btso = (1 << NS_TSO_SHIFT),             /* TSO desired (tx) */
414 };
415 #define BLOCK_META_FLAGS (Bipck | Budpck | Btcpck | Bpktck | Btso)
416 #define BLOCK_TRANS_TX_CSUM (Budpck | Btcpck)
417 #define BLOCK_RX_CSUM (Bipck | Budpck | Btcpck)
418
419 struct extra_bdata {
420         uintptr_t base;
421         /* using u32s for packing reasons.  this means no extras > 4GB */
422         uint32_t off;
423         uint32_t len;
424 };
425
426 struct block {
427         struct block *next;
428         struct block *list;
429         uint8_t *rp;                            /* first unconsumed byte */
430         uint8_t *wp;                            /* first empty byte */
431         uint8_t *lim;                           /* 1 past the end of the buffer */
432         uint8_t *base;                          /* start of the buffer */
433         void (*free) (struct block *);
434         uint16_t flag;
435         uint16_t mss;               /* TCP MSS for TSO */
436         uint16_t network_offset;        /* offset from start */
437         uint16_t transport_offset;      /* offset from start */
438         uint16_t tx_csum_offset;        /* offset from tx_offset to store csum */
439         /* might want something to track the next free extra_data slot */
440         size_t extra_len;
441         unsigned int nr_extra_bufs;
442         struct extra_bdata *extra_data;
443 };
444 #define BLEN(s) ((s)->wp - (s)->rp + (s)->extra_len)
445 #define BHLEN(s) ((s)->wp - (s)->rp)
446 #define BALLOC(s) ((s)->lim - (s)->base + (s)->extra_len)
447
448 struct chan {
449         spinlock_t lock;
450         struct kref ref;
451         struct chan *next;                      /* allocation */
452         struct chan *link;
453         int64_t offset;                         /* in file */
454         int type;
455         uint32_t dev;
456         uint16_t mode;                          /* read/write */
457         int flag;
458         struct qid qid;
459         int fid;                                        /* for devmnt */
460         uint32_t iounit;                        /* chunk size for i/o; 0==default */
461         struct mhead *umh;                      /* mount point that derived Chan; used in unionread */
462         struct chan *umc;                       /* channel in union; held for union read */
463         qlock_t umqlock;                        /* serialize unionreads */
464         int uri;                                        /* union read index */
465         int dri;                                        /* devdirread index */
466         uint32_t mountid;
467         struct mntcache *mcp;           /* Mount cache pointer */
468         struct mnt *mux;                        /* Mnt for clients using me for messages */
469         union {
470                 void *aux;
471                 char tag[4];                    /* for iproute */
472         };
473         /* mountpoint, as discovered during walk.
474          * Used for rename at present.
475          */
476         struct chan *mountpoint;
477         struct chan *mchan;                     /* channel to mounted server */
478         struct qid mqid;                        /* qid of root of mount point */
479         struct cname *name;
480         /* hack for dir reads to try to get them right. */
481         int ateof;
482         void *buf;
483         int bufused;
484         /* A lot of synthetic files need something generated at open time, which the
485          * user can read from (including offsets) while the underlying file changes.
486          * Hang that buffer here. */
487         void *synth_buf;
488 };
489
490 extern struct chan *kern_slash;
491
492 struct cname {
493         struct kref ref;
494         int alen;                                       /* allocated length */
495         int len;                                        /* strlen(s) */
496         char *s;
497 };
498
499 struct fs_file;
500
501 struct dev {
502         char *name;
503
504         void (*reset)(void);
505         void (*init)(void);
506         void (*shutdown)(void);
507         struct chan *(*attach)(char *muxattach);
508         struct walkqid *(*walk)(struct chan *, struct chan *, char **name,
509                                 unsigned int);
510         size_t (*stat)(struct chan *, uint8_t *, size_t);
511         struct chan *(*open)(struct chan *, int);
512         void (*create)(struct chan *, char *, int, uint32_t, char *);
513         void (*close)(struct chan *);
514         size_t (*read)(struct chan *, void *, size_t, off64_t);
515         struct block *(*bread)(struct chan *, size_t, off64_t);
516         size_t (*write)(struct chan *, void *, size_t, off64_t);
517         size_t (*bwrite)(struct chan *, struct block *, off64_t);
518         void (*remove)(struct chan *);
519         size_t (*wstat)(struct chan *, uint8_t *, size_t);
520         void (*power)(int);             /* power mgt: power(1) → on, power (0) → off */
521 //  int (*config)( int unused_int, char *unused_char_p_t, DevConf*);
522         char *(*chaninfo)(struct chan *, char *, size_t);
523         int (*tapfd)(struct chan *, struct fd_tap *, int);
524         int (*chan_ctl)(struct chan *, int);
525         struct fs_file *(*mmap)(struct chan *, struct vm_region *, int, int);
526         /* we need to be aligned to 64 bytes for the linker tables. */
527 } __attribute__ ((aligned(64)));
528
529 struct dirtab {
530         char name[KNAMELEN];
531         struct qid qid;
532         int64_t length;
533         int perm;
534         /* we need to be aligned to 64 bytes for the linker tables. */
535 } __attribute__ ((aligned(64)));
536
537 struct walkqid {
538         struct chan *clone;
539         int nqid;
540         struct qid qid[1];
541 };
542
543 enum {
544         NSMAX = 1000,
545         NSLOG = 7,
546         NSCACHE = (1 << NSLOG),
547 };
548
549 struct mntwalk {                                /* state for /proc/#/ns */
550         int cddone;
551         uint32_t id;
552         struct mhead *mh;
553         struct mount *cm;
554 };
555
556 struct mount {
557         uint32_t mountid;
558         struct mount *next;
559         struct mhead *head;
560         struct mount *copy;
561         struct mount *order;
562         struct chan *to;                        /* channel replacing channel */
563         int mflag;
564         char *spec;
565 };
566
567 struct mhead {
568         struct kref ref;
569         struct rwlock lock;
570         struct chan *from;                      /* channel mounted upon */
571         struct mount *mount;            /* what's mounted upon it */
572         struct mhead *hash;                     /* Hash chain */
573 };
574
575 struct mnt {
576         spinlock_t lock;
577         /* references are counted using c->ref; channels on this mount point incref(c->mchan) == Mnt.c */
578         struct chan *c;                         /* Channel to file service */
579         struct proc *rip;                       /* Reader in progress */
580         struct mntrpc *queue;           /* Queue of pending requests on this channel */
581         uint32_t id;                            /* Multiplexer id for channel check */
582         struct mnt *list;                       /* Free list */
583         int flags;                                      /* cache */
584         int msize;                                      /* data + IOHDRSZ */
585         char *version;                          /* 9P version */
586         struct queue *q;                        /* input queue */
587 };
588
589 enum {
590         RENDLOG = 5,
591         RENDHASH = 1 << RENDLOG,        /* Hash to lookup rendezvous tags */
592         MNTLOG = 5,
593         MNTHASH = 1 << MNTLOG,  /* Hash to walk mount table */
594         DELTAFD = 20,   /* allocation quantum for process file descriptors */
595         MAXNFD = 4000,  /* max per process file descriptors */
596         MAXKEY = 8,     /* keys for signed modules */
597 };
598 #define MOUNTH(p,qid)   ((p)->mnthash[(qid).path&((1<<MNTLOG)-1)])
599
600 struct mntparam {
601         struct chan *chan;
602         struct chan *authchan;
603         char *spec;
604         int flags;
605 };
606
607 struct pgrp {
608         struct kref ref;                        /* also used as a lock when mounting */
609         uint32_t pgrpid;
610         qlock_t debug;                          /* single access via devproc.c */
611         struct rwlock ns;                       /* Namespace n read/one write lock */
612         qlock_t nsh;
613         struct mhead *mnthash[MNTHASH];
614         int progmode;
615         int nodevs;
616         int pin;
617 };
618
619 struct evalue {
620         char *var;
621         char *val;
622         int len;
623         struct qid qid;
624         struct evalue *next;
625 };
626
627 struct egrp {
628         struct kref ref;
629         qlock_t qlock;
630         struct evalue *entries;
631         uint32_t path;                          /* qid.path of next Evalue to be allocated */
632         uint32_t vers;                          /* of Egrp */
633 };
634
635 struct signerkey {
636         struct kref ref;
637         char *owner;
638         uint16_t footprint;
639         uint32_t expires;
640         void *alg;
641         void *pk;
642         void (*pkfree) (void *);
643 };
644
645 struct skeyset {
646         struct kref ref;
647         qlock_t qlock;
648         uint32_t flags;
649         char *devs;
650         int nkey;
651         struct signerkey *keys[MAXKEY];
652 };
653
654 /*
655  * fasttick timer interrupts
656  */
657 enum {
658         /* Mode */
659         Trelative,                                      /* timer programmed in ns from now */
660         Tabsolute,                                      /* timer programmed in ns since epoch */
661         Tperiodic,                                      /* periodic timer, period in ns */
662 };
663
664 enum {
665         PRINTSIZE = 256,
666         NUMSIZE = 12,   /* size of formatted number */
667         MB = (1024 * 1024),
668         READSTR = 2000, /* temporary buffer size for device reads */
669 };
670
671 extern struct dev devtab[];
672 extern struct dev __devtabend[];
673
674 struct cmdbuf {
675         char *buf;
676         char **f;
677         int nf;
678 };
679
680 struct cmdtab {
681         int index;                                      /* used by client to switch on result */
682         char *cmd;                                      /* command name */
683         int narg;                                       /* expected #args; 0 ==> variadic */
684 };
685
686 /* queue state bits, all can be set in qopen (Qstarve is always set) */
687 enum {
688         Qmsg                    = (1 << 1),     /* message stream */
689         Qclosed                 = (1 << 2),     /* queue has been closed/hungup */
690         Qcoalesce               = (1 << 3),     /* coalesce empty packets on read */
691         Qkick                   = (1 << 4),     /* always call the kick routine after qwrite */
692         Qdropoverflow   = (1 << 5),     /* writes that would block will be dropped */
693 };
694
695 /* Per-process structs */
696 #define NR_OPEN_FILES_DEFAULT 32
697 #define NR_FILE_DESC_DEFAULT 32
698
699 /* Bitmask for file descriptors, big for when we exceed the initial small.  We
700  * could just use the fd_array to check for openness instead of the bitmask,
701  * but eventually we might want to use the bitmasks for other things (like
702  * which files are close_on_exec. */
703
704 typedef struct fd_set {
705     uint8_t fds_bits[BYTES_FOR_BITMASK(NR_FILE_DESC_MAX)];
706 } fd_set;
707
708
709 struct small_fd_set {
710     uint8_t fds_bits[BYTES_FOR_BITMASK(NR_FILE_DESC_DEFAULT)];
711 };
712
713 /* Helper macros to manage fd_sets */
714 #define FD_SET(n, p)    ((p)->fds_bits[(n) / 8] |=  (1 << ((n) & 7)))
715 #define FD_CLR(n, p)    ((p)->fds_bits[(n) / 8] &= ~(1 << ((n) & 7)))
716 #define FD_ISSET(n, p)  ((p)->fds_bits[(n) / 8] &   (1 << ((n) & 7)))
717 #define FD_ZERO(p)              memset((void*)(p), 0, sizeof(*(p)))
718
719 /* Describes an open file.  We need this, since the FD flags are supposed to be
720  * per file descriptor, not per file (like the file status flags). */
721 struct file_desc {
722         struct chan                                     *fd_chan;
723         unsigned int                            fd_flags;
724         struct fd_tap                           *fd_tap;
725 };
726
727 /* All open files for a process */
728 struct fd_table {
729         spinlock_t                                      lock;
730         bool                                            closed;
731         int                                                     max_files;              /* max files ptd to by fd */
732         int                                                     max_fdset;              /* max of the current fd_set */
733         int                                                     hint_min_fd;    /* <= min available fd */
734         struct file_desc                        *fd;                    /* initially pts to fd_array */
735         struct fd_set                           *open_fds;              /* init, pts to open_fds_init */
736         struct small_fd_set                     open_fds_init;
737         struct file_desc                        fd_array[NR_OPEN_FILES_DEFAULT];
738 };
739
740 ssize_t kread_file(struct file_or_chan *file, void *buf, size_t sz);
741 void *kread_whole_file(struct file_or_chan *file);
742
743 /* Process-related File management functions */
744 void *lookup_fd(struct fd_table *fdt, int fd, bool incref);
745 int insert_obj_fdt(struct fd_table *fdt, void *obj, int low_fd, int fd_flags,
746                    bool must_use_low);
747 bool close_fd(struct fd_table *fdt, int fd);
748 void close_fdt(struct fd_table *open_files, bool cloexec);
749 void clone_fdt(struct fd_table *src, struct fd_table *dst);
750
751 #define DEVDOTDOT -1
752
753 typedef int Devgen(struct chan *, char *unused_char_p_t, struct dirtab *,
754                                    int unused_int, int, struct dir *);
755
756 /* inferno portfns.h. Not all these are needed. */
757 #define         FPinit() fpinit()       /* remove this if math lib is linked */
758 void FPrestore(void *);
759 void FPsave(void *);
760 struct cname *addelem(struct cname *, char *unused_char_p_t);
761 void addprog(struct proc *);
762 void addrootfile(char *unused_char_p_t, uint8_t * unused_uint8_p_t, uint32_t);
763 struct block *adjustblock(struct block *, int);
764 struct block *block_alloc(size_t, int);
765 int block_add_extd(struct block *b, unsigned int nr_bufs, int mem_flags);
766 int block_append_extra(struct block *b, uintptr_t base, uint32_t off,
767                        uint32_t len, int mem_flags);
768 void block_copy_metadata(struct block *new_b, struct block *old_b);
769 void block_reset_metadata(struct block *b);
770 int anyhigher(void);
771 int anyready(void);
772 void _assert(char *unused_char_p_t);
773 struct block *bl2mem(uint8_t * unused_uint8_p_t, struct block *, int);
774 int blocklen(struct block *);
775 char *channame(struct chan *);
776 void cclose(struct chan *);
777 void chan_incref(struct chan *);
778 void chandevinit(void);
779 void chandevreset(void);
780 void chandevshutdown(void);
781 void chanfree(struct chan *);
782 void chanrec(struct mnt *);
783 void checkalarms(void);
784 void checkb(struct block *, char *unused_char_p_t);
785 void cinit(void);
786 struct chan *cclone(struct chan *);
787 void cclose(struct chan *);
788 void closeegrp(struct egrp *);
789 void closemount(struct mount *);
790 void closepgrp(struct pgrp *);
791 void closesigs(struct skeyset *);
792 void debugcmd(struct cmdbuf *cb);
793 struct mhead *newmhead(struct chan *from);
794 int cmount(struct chan *, struct chan *, int unused_int, char *unused_char_p_t);
795 void cnameclose(struct cname *);
796 struct block *concatblock(struct block *);
797 struct block *linearizeblock(struct block *b);
798 void confinit(void);
799 void cons_add_char(char c);
800 void copen(struct chan *);
801 struct block *copyblock(struct block *b, int mem_flags);
802 int cread(struct chan *, uint8_t * unused_uint8_p_t, int unused_int, int64_t);
803 struct chan *cunique(struct chan *);
804 struct chan *createdir(struct chan *, struct mhead *);
805 void cunmount(struct chan *, struct chan *);
806 void cupdate(struct chan *, uint8_t * unused_uint8_p_t, int unused_int,
807                          int64_t);
808 void cursorenable(void);
809 void cursordisable(void);
810 int cursoron(int);
811 void cursoroff(int);
812 void cwrite(struct chan *, uint8_t * unused_uint8_p_t, int unused_int, int64_t);
813 struct chan *devattach(const char *name, char *spec);
814 struct block *devbread(struct chan *, size_t, off64_t);
815 size_t devbwrite(struct chan *, struct block *, off64_t);
816 struct chan *devclone(struct chan *);
817 void devcreate(struct chan *, char *name, int mode, uint32_t perm, char *ext);
818 void devdir(struct chan *, struct qid, char *, int64_t, char *, long,
819                         struct dir *);
820 long devdirread(struct chan *, char *, long, struct dirtab *, int, Devgen *);
821 Devgen devgen;
822 void devinit(void);
823 int devno(const char *name, int user);
824 void devpower(int);
825 struct dev *devbyname(char *unused_char_p_t);
826 struct chan *devopen(struct chan *, int unused_int,
827                                          struct dirtab *, int unused_int2, Devgen *);
828 void devpermcheck(char *unused_char_p_t, uint32_t, int);
829 void devremove(struct chan *);
830 void devreset(void);
831 void devshutdown(void);
832 size_t dev_make_stat(struct chan *c, struct dir *dir, uint8_t *dp, size_t n);
833 size_t devstat(struct chan *, uint8_t *db, size_t n, struct dirtab *,
834                int ntab, Devgen *);
835 struct walkqid *devwalk(struct chan *,
836                                                 struct chan *, char **unused_char_pp_t, int unused_int,
837                                                 struct dirtab *, int unused_intw, Devgen *);
838 size_t devwstat(struct chan *, uint8_t *, size_t);
839 char *devchaninfo(struct chan *chan, char *ret, size_t ret_l);
840 void disinit(void *);
841 void disfault(void *, char *unused_char_p_t);
842 int domount(struct chan **, struct mhead **);
843 void drawactive(int);
844 void drawcmap(void);
845 void dumpstack(void);
846 void egrpcpy(struct egrp *, struct egrp *);
847 int emptystr(char *unused_char_p_t);
848 int eqchan(struct chan *, struct chan *, int);
849 int eqqid(struct qid, struct qid);
850
851 void errstr(char *unused_char_p_t, int);
852 void excinit(void);
853 void exit(int);
854 void reboot(void);
855 void halt(void);
856 int export(int unused_int, char *unused_char_p_t, int);
857 uint64_t fastticks(uint64_t *);
858 uint64_t fastticks2ns(uint64_t);
859 int findmount(struct chan **, struct mhead **, int unused_int, int, struct qid);
860 void free_block_extra(struct block *);
861 size_t freeb(struct block *b);
862 size_t freeblist(struct block *b);
863 void freeskey(struct signerkey *);
864 void getcolor(uint32_t, uint32_t *, uint32_t *, uint32_t *);
865 uint32_t getmalloctag(void *);
866 uint32_t getrealloctag(void *);
867 void printblock(struct block *b);
868 void ilock(spinlock_t *);
869 int iprint(char *unused_char_p_t, ...);
870 void isdir(struct chan *);
871 int islo(void);
872 void iunlock(spinlock_t *);
873 void ixsummary(void);
874 void kbdclock(void);
875 int kbdcr2nl(struct queue *, int);
876 int kbdputc(struct queue *, int);
877 void kbdrepeat(int);
878 void kproc(char *unused_char_p_t, void (*)(void *), void *, int);
879 void kprocchild(struct proc *, void (*)(void *), void *);
880 void (*kproftick) (uint32_t);
881 void ksetenv(char *unused_char_p_t, char *, int);
882 void kstrdup(char **cp, char *name);
883
884 struct block *mem2bl(uint8_t * unused_uint8_p_t, int);
885 int memusehigh(void);
886 void microdelay(int);
887 uint64_t mk64fract(uint64_t, uint64_t);
888 void mkqid(struct qid *, int64_t, uint32_t, int);
889 void modinit(void);
890 struct chan *mntauth(struct chan *, char *unused_char_p_t);
891 long mntversion(struct chan *, char *unused_char_p_t, int unused_int, int);
892 void mountfree(struct mount *);
893 void mousetrack(int unused_int, int, int, int);
894 uint64_t ms2fastticks(uint32_t);
895 void mul64fract(uint64_t *, uint64_t, uint64_t);
896 void muxclose(struct mnt *);
897 struct chan *namec(char *unused_char_p_t, int unused_int, int, uint32_t,
898                    void *ext);
899 struct chan *namec_from(struct chan *c, char *name, int amode, int omode,
900                         uint32_t perm, void *ext);
901 struct chan *newchan(void);
902 struct egrp *newegrp(void);
903 struct mount *newmount(struct mhead *, struct chan *, int unused_int,
904                                            char *unused_char_p_t);
905 struct pgrp *newpgrp(void);
906 struct proc *newproc(void);
907 char *nextelem(char *unused_char_p_t, char *);
908
909 struct cname *newcname(char *unused_char_p_t);
910 void notkilled(void);
911 uint32_t random_read(void *xp, uint32_t n);
912 uint32_t urandom_read(void *xp, uint32_t n);
913 uint64_t ns2fastticks(uint64_t);
914 int okaddr(uint32_t, uint32_t, int);
915 int omode_to_rwx(int);
916 int omode_to_9p_accmode(int open_flags);
917 int access_bits_to_omode(int access_bits);
918 struct block *packblock(struct block *);
919 struct block *padblock(struct block *, int);
920
921 void pgrpcpy(struct pgrp *, struct pgrp *);
922
923 int progfdprint(struct chan *, int unused_int, int, char *unused_char_p_t,
924                                 int i);
925 int pullblock(struct block **, int);
926 struct block *pullupblock(struct block *, int);
927 struct block *pullupqueue(struct queue *, int);
928 void putmhead(struct mhead *);
929 void putstrn(char *unused_char_p_t, int);
930 void qaddlist(struct queue *, struct block *);
931 struct block *qbread(struct queue *q, size_t len);
932 struct block *qbread_nonblock(struct queue *q, size_t len);
933 ssize_t qbwrite(struct queue *, struct block *);
934 ssize_t qbwrite_nonblock(struct queue *, struct block *);
935 ssize_t qibwrite(struct queue *q, struct block *b);
936 struct queue *qbypass(void (*)(void *, struct block *), void *);
937 int qcanread(struct queue *);
938 void qclose(struct queue *);
939 struct block *qcopy(struct queue *, int unused_int, uint32_t);
940 struct block *qclone(struct queue *q, int header_len, int len,
941                      uint32_t offset);
942 struct block *blist_clone(struct block *blist, int header_len, int len,
943                           uint32_t offset);
944 size_t qdiscard(struct queue *q, size_t len);
945 void qflush(struct queue *);
946 void qfree(struct queue *);
947 int qfull(struct queue *);
948 struct block *qget(struct queue *);
949 void qhangup(struct queue *, char *unused_char_p_t);
950 int qisclosed(struct queue *);
951 ssize_t qiwrite(struct queue *, void *, int);
952 int qlen(struct queue *);
953 size_t q_bytes_read(struct queue *q);
954 void qdropoverflow(struct queue *, bool);
955 void q_toggle_qmsg(struct queue *q, bool onoff);
956 void q_toggle_qcoalesce(struct queue *q, bool onoff);
957 struct queue *qopen(int unused_int, int, void (*)(void *), void *);
958 ssize_t qpass(struct queue *, struct block *);
959 ssize_t qpassnolim(struct queue *, struct block *);
960 void qputback(struct queue *, struct block *);
961 size_t qread(struct queue *q, void *va, size_t len);
962 size_t qread_nonblock(struct queue *q, void *va, size_t len);
963 void qreopen(struct queue *);
964 void qsetlimit(struct queue *, size_t);
965 size_t qgetlimit(struct queue *);
966 int qwindow(struct queue *);
967 ssize_t qwrite(struct queue *, void *, int);
968 ssize_t qwrite_nonblock(struct queue *, void *, int);
969 typedef void (*qio_wake_cb_t)(struct queue *q, void *data, int filter);
970 void qio_set_wake_cb(struct queue *q, qio_wake_cb_t func, void *data);
971 bool qreadable(struct queue *q);
972 bool qwritable(struct queue *q);
973
974 void *realloc(void *, uint32_t);
975 int readmem(unsigned long offset, char *buf, unsigned long n,
976                         const void *mem, size_t mem_len);
977 int readnum(unsigned long off, char *buf, unsigned long n, unsigned long val,
978                         size_t size);
979 int readnum_hex(unsigned long off, char *buf, unsigned long n,
980                 unsigned long val, size_t size);
981 int readstr(unsigned long offset, char *buf, unsigned long n, const char *str);
982 int readnum_int64_t(uint32_t, char *unused_char_p_t, uint32_t, int64_t, int);
983 unsigned long strtoul_from_ubuf(void *ubuf, size_t count, int base);
984 void ready(struct proc *);
985 void renameproguser(char *unused_char_p_t, char *);
986 void renameuser(char *unused_char_p_t, char *);
987 void resrcwait(char *unused_char_p_t);
988 struct proc *runproc(void);
989 void (*serwrite) (char *unused_char_p_t, int);
990 int setcolor(uint32_t, uint32_t, uint32_t, uint32_t);
991
992 void setmalloctag(void *, uint32_t);
993 int setpri(int);
994 void setrealloctag(void *, uint32_t);
995 char *skipslash(char *unused_char_p_t);
996 void *smalloc(uint32_t);
997 int splhi(void);
998 int spllo(void);
999 void splx(int);
1000 void splxpc(int);
1001 void swiproc(struct proc *, int);
1002 uint32_t _tas(uint32_t *);
1003 uint32_t tk2ms(uint32_t);
1004 #define         TK2MS(x) ((x)*(1000/HZ))
1005 uint64_t tod2fastticks(int64_t);
1006 int64_t todget(int64_t *);
1007 void todfix(void);
1008 void todsetfreq(int64_t);
1009 void todinit(void);
1010 void todset(int64_t, int64_t, int);
1011 int tready(void *);
1012 struct block *trimblock(struct block *, int unused_int, int);
1013 int uartgetc(void);
1014 void uartputc(int);
1015 void uartputs(char *unused_char_p_t, int);
1016 void unlock(spinlock_t *);
1017 void userinit(void);
1018 uint32_t userpc(void);
1019 void validname(char *, int);
1020 void validwstatname(char *);
1021 void *xalloc(uint32_t);
1022 void *xallocz(uint32_t, int);
1023 void xfree(void *);
1024 void xhole(uint32_t, uint32_t);
1025 void xinit(void);
1026 int xmerge(void *, void *);
1027 void *xspanalloc(uint32_t, int unused_int, uint32_t);
1028 void xsummary(void);
1029
1030 void validaddr(void *, uint32_t, int);
1031 void *vmemchr(void *, int unused_int, int);
1032 void hnputv(void *, int64_t);
1033 void hnputl(void *, uint32_t);
1034 void hnputs(void *, uint16_t);
1035 int64_t nhgetv(void *);
1036 uint32_t nhgetl(void *);
1037 uint16_t nhgets(void *);
1038
1039 char *get_cur_genbuf(void);
1040
1041 /* hack for now. */
1042 #define NOW     tsc2msec(read_tsc())
1043 #define seconds() tsc2sec(read_tsc())
1044 #define milliseconds() tsc2msec(read_tsc())
1045
1046 /* kern/drivers/dev/tab.c */
1047 void devtabinit();
1048 void devtabreset();
1049
1050 /* kern/src/ns/parse.c */
1051 struct cmdbuf *parsecmd(char *p, int n);
1052 void cmderror(struct cmdbuf *cb, char *s);
1053 struct cmdtab *lookupcmd(struct cmdbuf *cb, struct cmdtab *ctab, int nctab);
1054
1055 /* kern/src/ns/sysfile.c */
1056 int newfd(struct chan *c, int low_fd, int oflags, bool must_use_low);
1057 struct chan *fdtochan(struct fd_table *fdt, int fd, int mode, int chkmnt,
1058                       int iref);
1059 long kchanio(void *vc, void *buf, int n, int mode);
1060 int openmode(uint32_t o);
1061 void fdclose(struct fd_table *fdt, int fd);
1062 int syschdir(char *path);
1063 int sysfchdir(int fd);
1064 int grpclose(struct fd_table *fdt, int fd);
1065 int sysclose(int fd);
1066 int syscreate(char *path, int mode, uint32_t perm);
1067 int sysdup(int old, int low_fd, bool must_use_low);
1068 int sys_dup_to(struct proc *from_proc, unsigned int from_fd,
1069                struct proc *to_proc, unsigned int to_fd);
1070 int sysfstat(int fd, uint8_t*, int n);
1071 int sysfstatakaros(int fd, struct kstat *);
1072 char *sysfd2path(int fd);
1073 char *sysgetcwd(void);
1074 int sysfauth(int fd, char *aname);
1075 int sysfversion(int fd, unsigned int msize, char *vers, unsigned int arglen);
1076 int sysfwstat(int fd, uint8_t * buf, int n);
1077 long bindmount(struct chan *c, char *old, int flag, char *spec);
1078 int sysbind(char *new, char *old, int flags);
1079 int syssymlink(char *new_path, char *old_path);
1080 int sysmount(int fd, int afd, char *old, int flags, char *spec);
1081 int sysunmount(char *old, char *new);
1082 int sysopenat(int dirfd, char *path, int vfs_flags);
1083 int sysopen(char *path, int vfs_flags);
1084 long unionread(struct chan *c, void *va, long n);
1085 void read_exactly_n(struct chan *c, void *vp, long n);
1086 long sysread(int fd, void *va, long n);
1087 long syspread(int fd, void *va, long n, int64_t off);
1088 int sysremove(char *path);
1089 int64_t sysseek(int fd, int64_t off, int whence);
1090 void validstat(uint8_t * s, int n, int slashok);
1091 int sysstat(char *path, uint8_t*, int n);
1092 int syslstat(char *path, uint8_t*, int n);
1093 int sysstatakaros(char *path, struct kstat *, int flags);
1094 long syswrite(int fd, void *va, long n);
1095 long syspwrite(int fd, void *va, long n, int64_t off);
1096 int syswstat(char *path, uint8_t * buf, int n);
1097 struct dir *chandirstat(struct chan *c);
1098 struct dir *sysdirstat(char *name);
1099 struct dir *sysdirlstat(char *name);
1100 struct dir *sysdirfstat(int fd);
1101 int sysdirwstat(char *name, struct dir *dir);
1102 int sysdirfwstat(int fd, struct dir *dir);
1103 long sysdirread(int fd, struct kdirent **d);
1104 int sysiounit(int fd);
1105 void print_chaninfo(struct chan *ch);
1106 int plan9setup(struct proc *new_proc, struct proc *parent, int flags);
1107 int iseve(void);
1108 int fd_getfl(int fd);
1109 int fd_setfl(int fd, int flags);
1110
1111 /* kern/drivers/dev/srv.c */
1112 char *srvname(struct chan *c);
1113
1114 /* kern/src/eipconv.c. Put them here or face real include hell. */
1115 void printqid(void (*putch) (int, void **), void **putdat, struct qid *q);
1116 void printcname(void (*putch) (int, void **), void **putdat, struct cname *c);
1117 void printchan(void (*putch) (int, void **), void **putdat, struct chan *c);
1118
1119 /* kern/src/ns/util.c */
1120 bool caller_is_username(char *uid);
1121 bool caller_has_perms(char *fileuid, uint32_t perm, int omode);
1122 bool caller_has_dir_perms(struct dir *dir, int omode);
1123 void dir_perm_check(struct dir *dir, int omode);
1124
1125 static inline int abs(int a)
1126 {
1127         if (a < 0)
1128                 return -a;
1129         return a;
1130 }
1131
1132 extern struct username eve;
1133 extern unsigned int qiomaxatomic;
1134
1135 /* special sections */
1136 #define __devtab  __attribute__((__section__(".devtab")))
1137
1138 #define DEVVARS_ENTRY(name, fmt)                                               \
1139 struct dirtab __attribute__((__section__("devvars"))) __devvars_##name =       \
1140               {#name "!" fmt,                                                  \
1141                {(uint64_t)&(name), 0, QTFILE},                                 \
1142                sizeof((name)),                                                 \
1143                0444}