xref: /netbsd-src/sbin/mount_portal/examples/overview (revision b75abedac4cde97d49b0cc16fbe175dca459b84d)
1*b75abedaSsalo$NetBSD: overview,v 1.3 2003/07/26 19:46:33 salo Exp $
2854e99c5Sbgrayson
3854e99c5SbgraysonOverall notes:
4854e99c5Sbgrayson
5854e99c5Sbgrayson  1.  Whenever mounting anything with mount_portal, always
6854e99c5Sbgrayson    specify absolute paths.  By specifying an absolute path for the
7854e99c5Sbgrayson    configuration file, it can be re-parsed by sending a HUP to the
8854e99c5Sbgrayson    mount process.  But since mount_portal calls daemon(), which
9854e99c5Sbgrayson    does a chdir("/"), the re-parse will fail unless the
10854e99c5Sbgrayson    specified file is absolute, not relative.
11854e99c5Sbgrayson
12854e99c5Sbgrayson  2.  The mount point should always be specified as an absolute
13854e99c5Sbgrayson    path.  Otherwise, umount may not be able to unmount it, as it
14854e99c5Sbgrayson    first converts a relative path to an absolute path before
15854e99c5Sbgrayson    checking against the mounted file systems (see
16854e99c5Sbgrayson    realpath(3)).  If you mistakenly mount on portal, instead of
17854e99c5Sbgrayson    `pwd`/portal, you can umount with "umount -R portal", which
18854e99c5Sbgrayson    may seg fault, but it will umount.
19854e99c5Sbgrayson
20854e99c5SbgraysonDescriptions of files in this directory:
21854e99c5Sbgrayson
22854e99c5Sbgrayson  *.conf	Configuration files for the corresponding file
23854e99c5Sbgrayson  tcp.1		Simple and advanced tcp:  daytime and finger
24854e99c5Sbgrayson  fing.c	Program for tcp.1
25854e99c5Sbgrayson  fs.1		Simple fs
26854e99c5Sbgrayson  rfilter.1	Simple rfilter usage:  bunzip2/bzcat
27854e99c5Sbgrayson  rfilter.2	Advanced rfilter usage
28854e99c5Sbgrayson  advanced.1	A tutorial
2993051456Satatat  cvs.1		How to map a cvs server into your local file system
3093051456Satatat  cvs.pl	A perl script that does the work for the cvs configuration
31854e99c5Sbgrayson
32854e99c5SbgraysonIn progress:
33854e99c5Sbgrayson  wfilter.1	Simple wfilter usage:  bzip2
34854e99c5Sbgrayson
35854e99c5SbgraysonMost (if not all) of these examples were written by Brian Grayson
36*b75abedaSsalo(bgrayson@NetBSD.org).  Please contact me if you have problems or
37854e99c5Sbgraysonimprovements.
38