MOUNT_KFS(1M) 02/18/00 MOUNT_KFS(1M)
NAME
mount_kfs, umount_kfs - AppleShare mounter
SYNOPSIS
/usr/etc/mount_kfs filesystem directory type options
/usr/etc/mount_kfs directory
/usr/etc/mount_kfs filesystem
DESCRIPTION
The mount_kfs program is an AppleShare mounter. It lets the
user mount volumes from AppleShare servers on UNIX file
systems. Mounted file systems "look" like K-AShare volumes;
i.e., data forks appear as normal UNIX files, resource forks
appear in a special resource directory (.HSResource),
Macintosh desktop info (file type, creator, comments etc.)
is stored in a desktop database (.HSancillary), and
Macintosh ASCII characters in file names are mapped to
hexadecimal equivalents.
In general, users will not call mount_kfs directly but
instead use the xktalk(1) GUI to set up and manage KFS
mounts. The mount_kfs can also be called indirectly via
mount(1), using entries in the filesystem table (called
/etc/vfstab on Solaris, /etc/checklist on HP-UX, /etc/fstab
on other platforms). These entries can be generated by
xktalk(1) or configkfs(1m).
NOTE that if you are using an HP-UX system, you will have to
call mount_kfs directly (rather than via mount). In this
case, for convenience you can invoke mount_kfs with a single
argument (using either the filesystem or mount directory),
and mount_kfs will read the options that are stored in the
filesystem table.
OPTIONS
filesystem
is the name of the AppleShare volume to be mounted, in
the form <AppleShare Server Name>:<Volume Name>.
Because of limitations imposed by getmntent(3),
filesystem cannot contain any spaces. Use "\20" for
spaces and "\5F" for a "_"; e.g., to mount Larry's_160
on a AppleShare server called Larry's Macintosh, use:
"Larry's\20Macintosh:/Larry's\5F160". In fact, ANY 8-
bit character can be escaped via this convention, which
is simply the upper-case HEX ASCII code for the
character.
directory
is the name of the local directory upon which
filesystem will be mounted.
type must be "kfs".
Page 1 (printed 3/30/100)
MOUNT_KFS(1M) 02/18/00 MOUNT_KFS(1M)
options
are specified via a comma-separated list (no spaces) of
mounting options (see fstab(1)). mount_kfs supports
the following options:
bg if the first attempt fails, retry indefinitely in
the background.
fg retry in foreground. (Default)
notext
turns off the translation of End-of-Line
characters in files of Type TEXT.
retry=n
set number of foreground mount failure retries to
n. (Default = 0)
debug=n
Set the debug level to n. If n is nonzero,
debugging messages will be written to
/usr/adm/kfslog. (Contact Xinet's Customer Support
team if you need to know what the assigned values
of n mean.)
passwd=string
Use encrypted string for the AppleShare user
password (otherwise, you will be prompted for a
password, if necessary). Encrypted strings can
only be generated by configkfs.
user=string
Use string for the AppleShare user login name.
(Otherwise, you will be prompted for a name.)
zone=string, server=string, volname=string
Use these to set the zone, server, and volume name
of the AppleShare server being mounted (zone and
server are normally taken from the filesystem
flag). The default zone will be used if none is
specified.
SEE ALSO
xktalk(1), configkfs(1m), K-FS Administrator's Guide,
K-Talk Administrator's Guide
NOTES
AppleShare allows access control only at the directory
level, so changes to the ownership/access rights for files
will be ignored. User/group names that cannot be found in
/etc/passwd or /etc/group will be mapped to "nobody" and
will be logged to /usr/adm/appletalk/at_log.
Page 2 (printed 3/30/100)
