9ns: Add error_jmp(): jump with an existing error
[akaros.git] / kern / src / ns / dev.c
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 #include <vfs.h>
30 #include <kfs.h>
31 #include <slab.h>
32 #include <kmalloc.h>
33 #include <kref.h>
34 #include <string.h>
35 #include <stdio.h>
36 #include <assert.h>
37 #include <error.h>
38 #include <cpio.h>
39 #include <pmap.h>
40 #include <smp.h>
41 #include <net/ip.h>
42
43 extern uint32_t kerndate;
44 extern struct username eve;
45
46 void mkqid(struct qid *q, int64_t path, uint32_t vers, int type)
47 {
48         q->type = type;
49         q->vers = vers;
50         q->path = path;
51 }
52
53 int devno(const char *name, int user)
54 {
55         int i;
56
57         for (i = 0; &devtab[i] < __devtabend; i++) {
58                 if (!strcmp(devtab[i].name, name))
59                         return i;
60         }
61         if (user == 0)
62                 panic("Lookup of dev :%s: failed", name);
63
64         return -1;
65 }
66
67 void
68 devdir(struct chan *c, struct qid qid, char *n,
69            int64_t length, char *user, long perm, struct dir *db)
70 {
71         struct timespec now = nsec2timespec(epoch_nsec());
72
73         db->name = n;
74         if (c->flag & CMSG)
75                 qid.type |= QTMOUNT;
76         db->qid = qid;
77         db->type = c->type;     /* used to use the dev's dc here */
78         db->dev = c->dev;
79         db->mode = perm;
80         db->mode |= qid.type << 24;
81         db->length = length;
82         db->uid = user;
83         db->gid = eve.name;
84         db->muid = user;
85         db->ext = NULL;
86         /* TODO: once we figure out what to do for uid/gid, then we can try to tie
87          * that to the n_uid.  Or just ignore it, and only use that as a
88          * pass-through for 9p2000.u. */
89         db->n_uid = 0;
90         db->n_gid = 0;
91         db->n_muid = 0;
92         /* TODO: what does devdir really want? */
93         db->atime = now;
94         db->btime = now;
95         db->ctime = now;
96         db->mtime = now;
97 }
98
99 /*
100  * The zeroth element of the table MUST be the directory itself, or '.' (dot),
101  * for processing '..' (dot-dot). Specifically, if i==DEVDOTDOT, we call devdir
102  * on the *directory* (that is, dot), as opposed to children of the directory.
103  * The rest of the system assumes that the first entry in the table refers to
104  * the directory, and by convention this is named '.' (dot). This is confusing.
105  *
106  * Any entry with qid verion of -1 will return 0, indicating that the value is
107  * valid but there is nothing there, so continue walking.
108  *
109  * TODO(cross): Document devgen and clean this mess up. Devgen should probably
110  * be removed and replaced with a smarter data structure.
111  *
112  * Keep in mind that the expected behavior of gen functions that interoperate
113  * with dev functions (e.g. devdirread()) is that files are directly genned, but
114  * not directories.  Directories will fail to gen, and devstat() just makes
115  * something up.  See also:
116  * https://github.com/brho/plan9/blob/89d43d2262ad43eb4b26c2a8d6a27cfeddb33828/nix/sys/src/nix/port/dev.c#L74
117  *
118  * The comment about genning a file's siblings needs a grain of salt too.  Look
119  * through ipgen().  I think it's what I call "direct genning." */
120 int
121 devgen(struct chan *c, char *unused_name, struct dirtab *tab, int ntab,
122        int i, struct dir *dp)
123 {
124         if (tab == NULL)
125                 return -1;
126         if (i != DEVDOTDOT) {
127                 /* Skip over the first element, that for the directory itself. */
128                 i++;
129                 if (i < 0 || ntab <= i)
130                         return -1;
131                 tab += i;
132         }
133         if (tab->qid.vers == -1)
134                 return 0;
135         devdir(c, tab->qid, tab->name, tab->length, eve.name, tab->perm, dp);
136         return 1;
137 }
138
139 void devreset(void)
140 {
141 }
142
143 void devinit(void)
144 {
145 }
146
147 void devshutdown(void)
148 {
149 }
150
151 struct chan *devattach(const char *name, char *spec)
152 {
153         struct chan *c;
154         char *buf;
155         size_t buflen;
156
157         c = newchan();
158         mkqid(&c->qid, 0, 0, QTDIR);
159         c->type = devno(name, 0);
160         if (spec == NULL)
161                 spec = "";
162         /* 1 for #, 1 for ., 1 for \0 */
163         buflen = strlen(name) + strlen(spec) + 3;
164         buf = kzmalloc(buflen, MEM_WAIT);
165         snprintf(buf, sizeof(buf), "#%s.%s", name, spec);
166         c->name = newcname(buf);
167         kfree(buf);
168         return c;
169 }
170
171 struct chan *devclone(struct chan *c)
172 {
173         struct chan *nc;
174
175         /* In plan 9, you couldn't clone an open chan.  We're allowing it, possibly
176          * foolishly.  The new chan is a non-open, "kernel internal" chan.  Note
177          * that c->flag isn't set, for instance.  c->mode is, which might be a
178          * problem.  The newchan should eventually have a device's open called on
179          * it, at which point it upgrades from a kernel internal chan to one that
180          * can refer to an object in the device (e.g. grab a refcnt on a
181          * conversation in #ip).
182          *
183          * Either we allow devclones of open chans, or O_PATH walks do not open a
184          * file.  It's nice to allow the device to do something for O_PATH, but
185          * perhaps that is not critical.  However, if we can't clone an opened chan,
186          * then we can *only* openat from an FD that is O_PATH, which is not the
187          * spec (and not as useful). */
188         if ((c->flag & COPEN) && !(c->flag & O_PATH))
189                 panic("clone of non-O_PATH open file type %s\n", devtab[c->type].name);
190
191         nc = newchan();
192         nc->type = c->type;
193         nc->dev = c->dev;
194         nc->mode = c->mode;
195         nc->qid = c->qid;
196         nc->offset = c->offset;
197         nc->umh = NULL;
198         nc->mountid = c->mountid;
199         nc->aux = c->aux;
200         nc->mqid = c->mqid;
201         nc->mcp = c->mcp;
202         return nc;
203 }
204
205 struct walkqid *devwalk(struct chan *c,
206                                                 struct chan *nc, char **name, int nname,
207                                                 struct dirtab *tab, int ntab, Devgen * gen)
208 {
209         ERRSTACK(1);
210         int i, j;
211         volatile int alloc;                     /* to keep waserror from optimizing this out */
212         struct walkqid *wq;
213         char *n;
214         struct dir dir;
215
216         if (nname > 0)
217                 isdir(c);
218
219         alloc = 0;
220         wq = kzmalloc(sizeof(struct walkqid) + nname * sizeof(struct qid),
221                                   MEM_WAIT);
222         if (waserror()) {
223                 if (alloc && wq->clone != NULL)
224                         cclose(wq->clone);
225                 kfree(wq);
226                 poperror();
227                 return NULL;
228         }
229         if (nc == NULL) {
230                 nc = devclone(c);
231                 /* inferno was setting this to 0, assuming it was devroot.  lining up
232                  * with chanrelease and newchan */
233                 nc->type = -1;  /* device doesn't know about this channel yet */
234                 alloc = 1;
235         }
236         wq->clone = nc;
237
238         dir.qid.path = 0;
239         for (j = 0; j < nname; j++) {
240                 if (!(nc->qid.type & QTDIR)) {
241                         if (j == 0)
242                                 error(ENOTDIR, ERROR_FIXME);
243                         goto Done;
244                 }
245                 n = name[j];
246                 if (strcmp(n, ".") == 0) {
247 Accept:
248                         wq->qid[wq->nqid++] = nc->qid;
249                         continue;
250                 }
251                 if (strcmp(n, "..") == 0) {
252                         (*gen) (nc, NULL, tab, ntab, DEVDOTDOT, &dir);
253                         nc->qid = dir.qid;
254                         goto Accept;
255                 }
256                 /*
257                  * Ugly problem: If we're using devgen, make sure we're
258                  * walking the directory itself, represented by the first
259                  * entry in the table, and not trying to step into a sub-
260                  * directory of the table, e.g. /net/net. Devgen itself
261                  * should take care of the problem, but it doesn't have
262                  * the necessary information (that we're doing a walk).
263                  */
264                 if (gen == devgen && nc->qid.path != tab[0].qid.path)
265                         goto Notfound;
266                 dir.qid.path = 0;
267                 for (i = 0;; i++) {
268                         switch ((*gen) (nc, n, tab, ntab, i, &dir)) {
269                                 case -1:
270                                         printd("DEVWALK -1, i was %d, want path %p\n", i,
271                                                    c->qid.path);
272 Notfound:
273                                         set_error(ENOENT, "could not find name %s, dev %s", n,
274                                                       c->type == -1 ? "no dev" : devtab[c->type].name);
275                                         if (j == 0)
276                                                 error_jmp();
277                                         goto Done;
278                                 case 0:
279                                         printd("DEVWALK continue, i was %d\n", i);
280                                         continue;
281                                 case 1:
282                                         printd
283                                                 ("DEVWALK gen returns path %p name %s, want path %p\n",
284                                                  dir.qid.path, dir.name, c->qid.path);
285                                         if (strcmp(n, dir.name) == 0) {
286                                                 nc->qid = dir.qid;
287                                                 goto Accept;
288                                         }
289                                         continue;
290                         }
291                 }
292         }
293         /*
294          * We processed at least one name, so will return some data.
295          * If we didn't process all nname entries succesfully, we drop
296          * the cloned channel and return just the Qids of the walks.
297          */
298 Done:
299         poperror();
300         if (wq->nqid < nname) {
301                 if (alloc)
302                         cclose(wq->clone);
303                 wq->clone = NULL;
304         } else if (wq->clone) {
305                 /* attach cloned channel to same device */
306                 wq->clone->type = c->type;
307         } else {
308                 /* Not sure this is possible, would like to know. */
309                 warn_once("had enough names, but still no wq->clone");
310         }
311         return wq;
312 }
313
314 /* Helper, makes a stat in @dp, given @n bytes, from chan @c's contents in @dir.
315  * Throws on error, returns the size used on success. */
316 size_t dev_make_stat(struct chan *c, struct dir *dir, uint8_t *dp, size_t n)
317 {
318         if (c->flag & CMSG)
319                 dir->mode |= DMMOUNT;
320         n = convD2M(dir, dp, n);
321         if (n == 0)
322                 error(EINVAL, ERROR_FIXME);
323         return n;
324 }
325
326 size_t devstat(struct chan *c, uint8_t *db, size_t n, struct dirtab *tab,
327                int ntab, Devgen *gen)
328 {
329         int i;
330         struct dir dir;
331         char *p, *elem;
332
333         dir.qid.path = 0;
334         for (i = 0;; i++)
335                 switch ((*gen) (c, NULL, tab, ntab, i, &dir)) {
336                         case -1:
337                                 if (c->qid.type & QTDIR) {
338                                         printd("DEVSTAT got a dir: %llu\n", c->qid.path);
339                                         if (c->name == NULL)
340                                                 elem = "???";
341                                         else if (strcmp(c->name->s, "/") == 0)
342                                                 elem = "/";
343                                         else
344                                                 for (elem = p = c->name->s; *p; p++)
345                                                         if (*p == '/')
346                                                                 elem = p + 1;
347                                         devdir(c, c->qid, elem, 0, eve.name, DMDIR | 0555, &dir);
348                                         n = convD2M(&dir, db, n);
349                                         if (n == 0)
350                                                 error(EINVAL, ERROR_FIXME);
351                                         return n;
352                                 }
353                                 printd("DEVSTAT fails:%s %llu\n", devtab[c->type].name,
354                                            c->qid.path);
355                                 error(ENOENT, ERROR_FIXME);
356                         case 0:
357                                 printd("DEVSTAT got 0\n");
358                                 break;
359                         case 1:
360                                 printd("DEVSTAT gen returns path %p name %s, want path %p\n",
361                                            dir.qid.path, dir.name, c->qid.path);
362                                 if (c->qid.path == dir.qid.path)
363                                         return dev_make_stat(c, &dir, db, n);
364                                 break;
365                 }
366 }
367
368 long
369 devdirread(struct chan *c, char *d, long n,
370                    struct dirtab *tab, int ntab, Devgen * gen)
371 {
372         long m, dsz;
373         /* this is gross. Make it 2 so we have room at the end for
374          * bad things.
375          */
376         struct dir dir[4];
377
378         dir[0].qid.path = 0;
379         for (m = 0; m < n; c->dri++) {
380                 switch ((*gen) (c, NULL, tab, ntab, c->dri, &dir[0])) {
381                         case -1:
382                                 printd("DEVDIRREAD got -1, asked for s = %d\n", c->dri);
383                                 return m;
384
385                         case 0:
386                                 printd("DEVDIRREAD got 0, asked for s = %d\n", c->dri);
387                                 break;
388
389                         case 1:
390                                 printd("DEVDIRREAD got 1, asked for s = %d\n", c->dri);
391                                 dsz = convD2M(&dir[0], (uint8_t *) d, n - m);
392                                 if (dsz <= BIT16SZ) {   /* <= not < because this isn't stat; read is stuck */
393                                         if (m == 0)
394                                                 error(ENODATA, ERROR_FIXME);
395                                         return m;
396                                 }
397                                 m += dsz;
398                                 d += dsz;
399                                 break;
400                 }
401         }
402
403         return m;
404 }
405
406 /*
407  * Throws an error if open permission not granted for current->user.name
408  */
409 void devpermcheck(char *fileuid, uint32_t perm, int omode)
410 {
411         if (!caller_has_perms(fileuid, perm, omode))
412                 error(EPERM, "permcheck(user: %s, rwx: 0%o, omode 0%o) failed",
413                       fileuid, perm, omode);
414 }
415
416 struct chan *devopen(struct chan *c, int omode, struct dirtab *tab, int ntab,
417                                          Devgen * gen)
418 {
419         int i;
420         struct dir dir;
421
422         dir.qid.path = 0;
423         for (i = 0;; i++) {
424                 switch ((*gen) (c, NULL, tab, ntab, i, &dir)) {
425                         case -1:
426                                 goto Return;
427                         case 0:
428                                 break;
429                         case 1:
430                                 if (c->qid.path == dir.qid.path) {
431                                         devpermcheck(dir.uid, dir.mode, omode);
432                                         goto Return;
433                                 }
434                                 break;
435                 }
436         }
437 Return:
438         c->offset = 0;
439         if ((c->qid.type & QTDIR) && (omode & O_WRITE))
440                 error(EACCES, "Tried opening dir with non-read-only mode %o", omode);
441         c->mode = openmode(omode);
442         c->flag |= COPEN;
443         return c;
444 }
445
446 void devcreate(struct chan *c, char *unused_char_p_t, int unused_int,
447                uint32_t u, char *ext)
448 {
449         error(EPERM, ERROR_FIXME);
450 }
451
452 struct block *devbread(struct chan *c, size_t n, off64_t offset)
453 {
454         ERRSTACK(1);
455         struct block *bp;
456
457         bp = block_alloc(n, MEM_WAIT);
458         if (bp == 0)
459                 error(ENOMEM, ERROR_FIXME);
460         if (waserror()) {
461                 freeb(bp);
462                 nexterror();
463         }
464         bp->wp += devtab[c->type].read(c, bp->wp, n, offset);
465         poperror();
466         return bp;
467 }
468
469 size_t devbwrite(struct chan *c, struct block *bp, off64_t offset)
470 {
471         ERRSTACK(1);
472         long n;
473
474         if (waserror()) {
475                 freeb(bp);
476                 nexterror();
477         }
478         n = devtab[c->type].write(c, bp->rp, BLEN(bp), offset);
479         poperror();
480         freeb(bp);
481
482         return n;
483 }
484
485 void devremove(struct chan *c)
486 {
487         error(EPERM, ERROR_FIXME);
488 }
489
490 size_t devwstat(struct chan *c, uint8_t *unused_uint8_p_t, size_t i)
491 {
492         error(EPERM, ERROR_FIXME);
493         return 0;
494 }
495
496 void devpower(int i)
497 {
498         error(EPERM, ERROR_FIXME);
499 }
500
501 #if 0
502 int devconfig(int unused_int, char *c, DevConf *)
503 {
504         error(EPERM, ERROR_FIXME);
505         return 0;
506 }
507 #endif
508
509 char *devchaninfo(struct chan *chan, char *ret, size_t ret_l)
510 {
511         snprintf(ret, ret_l, "qid.path: %p, qid.type: %02x", chan->qid.path,
512                          chan->qid.type);
513         return ret;
514 }
515
516 /*
517  * check that the name in a wstat is plausible
518  */
519 void validwstatname(char *name)
520 {
521         validname(name, 0);
522         if (strcmp(name, ".") == 0 || strcmp(name, "..") == 0)
523                 error(EINVAL, ERROR_FIXME);
524 }
525
526 struct dev *devbyname(char *name)
527 {
528         int i;
529
530         for (i = 0; &devtab[i] < __devtabend; i++)
531                 if (strcmp(devtab[i].name, name) == 0)
532                         return &devtab[i];
533         return NULL;
534 }