Sync usage with man page.
[netbsd-mini2440.git] / sbin / mount_portal / examples / overview
blob2a7ce7d267b5da7bded690cc14f5eb1a767b3b0b
1 $NetBSD: overview,v 1.2 2001/10/11 18:41:12 atatat Exp $
3 Overall notes:
5   1.  Whenever mounting anything with mount_portal, always
6     specify absolute paths.  By specifying an absolute path for the
7     configuration file, it can be re-parsed by sending a HUP to the
8     mount process.  But since mount_portal calls daemon(), which
9     does a chdir("/"), the re-parse will fail unless the
10     specified file is absolute, not relative.
12   2.  The mount point should always be specified as an absolute
13     path.  Otherwise, umount may not be able to unmount it, as it
14     first converts a relative path to an absolute path before
15     checking against the mounted file systems (see
16     realpath(3)).  If you mistakenly mount on portal, instead of
17     `pwd`/portal, you can umount with "umount -R portal", which
18     may seg fault, but it will umount.
20 Descriptions of files in this directory:
22   *.conf        Configuration files for the corresponding file
23   tcp.1         Simple and advanced tcp:  daytime and finger
24   fing.c        Program for tcp.1
25   fs.1          Simple fs
26   rfilter.1     Simple rfilter usage:  bunzip2/bzcat
27   rfilter.2     Advanced rfilter usage
28   advanced.1    A tutorial
29   cvs.1         How to map a cvs server into your local file system
30   cvs.pl        A perl script that does the work for the cvs configuration
32 In progress:
33   wfilter.1     Simple wfilter usage:  bzip2
35 Most (if not all) of these examples were written by Brian Grayson
36 (bgrayson@NetBSD.org).  Please contact me if you have problems or
37 improvements.