MOUNTKFS(1M)                  29                   MOUNTKFS(1M)



     NAME
          mount_kfs, umount_kfs -  AppleShare mounter

     SYNOPSIS
          /usr/etc/mountkfs filesystem directory type options
          /usr/etc/mountkfs directory
          /usr/etc/mountkfs 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 xkfs(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 xkfs(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/25/98)

     MOUNTKFS(1M)                  29                   MOUNTKFS(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)

               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
          xkfs(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/25/98)