xref: /src/sbin/mount_portal/examples/overview

$NetBSD: overview,v 1.1 1999/08/16 06:42:48 bgrayson Exp $

Overall notes:

  1.  Whenever mounting anything with mount_portal, always
    specify absolute paths.  By specifying an absolute path for the
    configuration file, it can be re-parsed by sending a HUP to the
    mount process.  But since mount_portal calls daemon(), which
    does a chdir("/"), the re-parse will fail unless the
    specified file is absolute, not relative.

  2.  The mount point should always be specified as an absolute
    path.  Otherwise, umount may not be able to unmount it, as it
    first converts a relative path to an absolute path before
    checking against the mounted file systems (see
    realpath(3)).  If you mistakenly mount on portal, instead of
    `pwd`/portal, you can umount with "umount -R portal", which
    may seg fault, but it will umount.

Descriptions of files in this directory:

  *.conf	Configuration files for the corresponding file
  tcp.1		Simple and advanced tcp:  daytime and finger
  fing.c	Program for tcp.1
  fs.1		Simple fs
  rfilter.1	Simple rfilter usage:  bunzip2/bzcat
  rfilter.2	Advanced rfilter usage
  advanced.1	A tutorial

In progress:
  wfilter.1	Simple wfilter usage:  bzip2

Most (if not all) of these examples were written by Brian Grayson
(bgrayson@netbsd.org).  Please contact me if you have problems or
improvements.