summaryrefslogtreecommitdiff
path: root/hurd/interface/fsys/02.mdwn
blob: e5223e380c849fd503af36e7f5ec25a734d8b3eb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
[[!meta copyright="Copyright © 1992, 1993, 1994, 1995, 1996, 1997, 2002, 2009,
2014 Free Software Foundation, Inc."]]

[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable
id="license" text="Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License, Version 1.2 or
any later version published by the Free Software Foundation; with no Invariant
Sections, no Front-Cover Texts, and no Back-Cover Texts.  A copy of the license
is included in the section entitled [[GNU Free Documentation
License|/fdl]]."]]"""]]

[[!meta title="fsys_getroot"]]

    routine fsys_getroot(
    	fsys: fsys_t;
    	RPT
    #ifdef	FSYS_GETROOT_UREPLY
    	ureplyport ureply: mig_reply_port_t;
    #endif
    	dotdot_node: mach_port_send_t;
    	gen_uids: idarray_t;
    	gen_gids: idarray_t;
    	flags: int;
    	out do_retry: retry_type;
    	out retry_name: string_t;
    	out file: mach_port_send_t);

Return a file to the root of the filesystem.  `flags` are as for
[[`dir_lookup`|dir_lookup]] (but `O_CREAT` and `O_EXCL` are not meaningful).
`do_retry`, `retry_name`, and `result` are as for [[`dir_lookup`|dir_lookup]].
The port should be authenticated with `gen_uids` and `gen_gids` (except, of
course, for `FS_RETRY_REAUTH` and `FS_RETRY_MAGICAL`).  `dotdot_node` is an
unauthenticated port for the directory in which this root is located.