MOUNT_KFS(1M)		 02/18/00		 MOUNT_KFS(1M)



     NAME    [Toc]    [Back]
	  mount_kfs, umount_kfs	-  AppleShare mounter

     SYNOPSIS    [Toc]    [Back]
	  /usr/etc/mount_kfs filesystem	directory type options
	  /usr/etc/mount_kfs directory
	  /usr/etc/mount_kfs filesystem

     DESCRIPTION    [Toc]    [Back]
	  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    [Toc]    [Back]
	  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)