Provided by: sfs-common_0.8-0+pre20050819.1-2_i386
dirsearch - search for file in directories
dirsearch [-c │ -l │ -p │ -q] dir1 [dir2 ...] name
dirsearch looks for a file name in one or more directories. Starting
with dir1, the command searches each directory specified for a file
called name. If such a file is found, dirsearch exits with code 0 and,
depending on its options, may print the file’s pathname, contents, or
expanded symbolic link contents. If none of the directories specified
contain a file name, dirsearch exits with code 1 and prints no output.
The following mutually exclusive options affect the behavior of
dirsearch. If more than one option is specified, only the last will
have an effect.
-c This option prints the contents of the file when it is found,
instead of its pathname.
-l This option looks for symbolic links. The file name will be
ignored if it is not a symbolic link. Furthermore, in its output
dirsearch will expand the symbolic link.
-p This option says to print the pathname, which is the default
anyway. Thus, the only effect of -p is to undo any previous -c,
-l, or -q option.
-q This option suppresses any output dirsearch would print. The exit
code still indicates whether or not the file exists.
dirsearch is particularly useful for SFS certification and revocation
programs. As an example, suppose you have a directory of symbolic
links in your home directory called .sfs/bookmarks. The directory
might contain the following links:
sfs.fs.net -> /firstname.lastname@example.org,uzwadtctbjb3dg596waiyru8cx5kb4an
sfs.nyu.edu -> /email@example.com,hcbafipmin3eqmsgak2m6heequppitiz
If you execute the command:
sfskey certprog dirsearch -l ~/.sfs/bookmarks
Then the next time you access /sfs/sfs.fs.net, that pathname will
automatically become a symbolic link to your bookmark. Moreover, the
same will happen on remote machines to which you log in with the rex
newaid(1), rex(1), sfsagent(1), sfskey(1), ssu(1), sfs_config(5),
sfs_hosts(5), sfs_srp_params(5), sfs_users(5), sfsauthd_config(5),
sfscd_config(5), sfsrosd_config(5), sfsrwsd_config(5), sfssd_config(5),
sfs_environ(7), funmount(8), nfsmounter(8), sfsauthd(8), sfscd(8),
sfsrosd(8), sfsrwcd(8), sfsrwsd(8), sfssd(8), vidb(8)
The full documentation for SFS is maintained as a Texinfo manual. If
the info and SFS programs are properly installed at your site, the
command info SFS should give you access to the complete manual.
For updates, documentation, and software distribution, please see the
SFS website at http://www.fs.net/.