NAME
dtmount, udtmount - desktop mount and undesktop mount NFS file
systems

SYNOPSIS
dtmount [ -o options ] <rhost:path> node
udtmount <rhost:path> node

DESCRIPTION
Dtmount announces to the system that the NFS file system present on
the remote server rhost:path or the local path node is to be made
visible on the Macintosh desktop. The file node must exist already
and rhost:path must already be mounted on it. If either
<rhost:path> or node are not provided, the appropriate information
is taken from the fstab file.

Options are specified by a -o argument followed by a comma
separated string of options.

Dtmount is equivalent to running the mount command with the dtnfs
flag and the -u flag, which indicates that the status of an already
mounted file system should be changed. It is not necessary to
specify either the dtnfs the -u flag to the dtmount command, as
both are internally forced on. By doing this, dtmount is limited
to only updating the status of an already mounted NFS file system,
so dtmount can safely be installed with set uid root. This which
allows non root users to add and remove NFS file servers to and
from the Macintosh desktop without changing the mount status of
these NFS files systems with respect to the Unix processes running
on the system.

The set of options is determined by first extracting the options
for the file system from the fstab table, then applying any options
specified by the -o argument.

The following list of options can be specified in the dtmount
command. All other traditional mount options should be specified
to the mount command at the time the NFS file system is originally
mounted.

lockd Support Macintosh file and record locking using the SUN
file locking daemon (lockd or rpc.lockd).

bw_lock Support Macintosh file and record locking using the
Beame and Whiteside file locking daemon (bwnfsd).

bw_auth Prompt the user (using a Macintosh dialog box) for a
username and password for each DTNFS volume being added
to the desktop. The username and password are
authenticated on the server via bwnfsd. If the
authentication succeeds, the server returns the
credentials to be used when accessing this DTNFS
volume.

bw_auth2,username,password
It is also possible to specify a username and password
on the dtmount command line. This situation could be
used if an administrator was setting up a MachTen
system for a particular user, and it was desirable to
mount the DTNFS volumes automatically, without any
interaction from the user. The username and password
are authenticated on the server via bwnfsd. If the
authentication succeeds, the server returns the
credentials to be used when accessing this DTNFS
volume.

bw_auth3,userid,password
It is also possible to specify a userid and password on
the dtmount command line. The userid and password are
authenticated on the server via bwnfsd. If the
authentication succeeds, the server returns the
credentials to be used when accessing this DTNFS
volume.

double When creating files on the DTNFS volume, use the
AppleDouble method of encapsulating Macintosh files,
rather than the default AppleSingle method of
encapsulation.

nobw_map Use this option to disable DTNFS’s default use of the
bwnfsd’s mapping services. Bwnfsd provides this
mapping service to translate numberic user and group
ids to their corresponding symbolic names. These names
are displayed by the Finder in the "Sharing..." info
box. DTNFS uses the mapping service of bwnfsd by
default, if it finds a bwnfsd daemon on the NFS Server.
If DTNFS does not find a bwnfsd daemon running on the
NFS Server, uids and gid are mapped to the strings
"user %d" and "group %d", where %d represents the
numberic uid or gid.

udtmount announces to the system that the file system mounted on
node or file system <rhost:path> should be removed from the
Macintosh desktop. The underlying NFS server is not unmounted and
is still within the scope of the Unix processes.

If the -a option is present for dtmount or udtmount all of the file
systems described in fstab are DTNFS mounted or unmounted.

FILES
/etc/fstab file system table

SEE ALSO
fstab(5), mount(8)

NOTES
If a DTNFS volume is mounted without specifying one of the forms of
bwnfsd authentication, the DTNFS volume is mounted using the
credentials of the user who executed the dtmount command. In this
case the user was authenticated at login time, usually using the
local /etc/passwd database. To minimize confusion when accessing
the DTNFS volume, the local database should mimic the database on
the NFS server.

Once a DTNFS volume appears on the desktop, the credentials
assigned to this volume are used by all Macintosh applications that
make requests of this volume. These credentials stay with this
DTNFS volume until it is removed from the Macintosh desktop,
regardless of subsequent users logging in on the MachTen Console.
If a user wishes to prevent unauthorized access to the DTNFS volume
after the user has logged out, the user must explicitly remove the
DTNFS volume from the desktop. This can be done either by using
the Finder and dragging the DTNFS volume to the trashcan, or by
issuing a udtmount command.

DTNFS volumes may not be removed from the desktop if any Macintosh
application has files open on the DTNFS volume. In this case, the
udtmount command will fail with an error code, or the Finder will
complain that the volume is in use if the user attempts to drag it
to the trashcan.

Traditional AppleShare volumes will timeout and return an error
code if the connection to the server is lost. To simulate this
behavior in DeskTop NFS, the soft option should be used when the
NFS volume is originally mounted.