NAME

walk − descend a directory hierarchy

SYNOPSIS

Twalk tag[2] fid[2] name[28]
Rwalk tag[2] fid[2] qid[8]

DESCRIPTION

The ­walk request looks for the file ­name in the directory represented by fid.

For the ­walk to succeed, the file identified by ­fid must be a directory, and the implied user of the request must have permission to search the directory (see intro(5)).

After a successful walk, ­fid represents the specified file.  The ­qid for the new file is returned with the ­walk reply message. 

A ­walk of the name ­..  in the root directory of a server is a no-op. 

ENTRY POINTS

The ­chdir system call causes a walk.  One or more ­walk messages may be generated by any of the following calls, which evaluate file names: bind, create, mount, open, remove, stat, unmount, wstat.  The file name element ­.  (dot) is interpreted locally and is not transmitted in ­walk messages. 

SEE ALSO

sys-bind(2), sys-chdir(2), sys-open(2), sys-remove(2), sys-stat(2), intro(5)

Plan 9  —  June 29, 2000