DTMOUNT(8) MachTen Programmer’s Manual DTMOUNT(8)

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 is safely installed with set uid root. This
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 user-
name and password are authenticated on the
server via bwnfsd. If the authentication suc-
ceeds, 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 particu-
lar 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 suc-
ceeds, 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 Macin-
tosh files, rather than the default AppleSin-
gle method of encapsulation.

nobw_map Use this option to disable DTNFS’s default use
of the bwnfsd’s mapping services. Bwnfsd pro-
vides this mapping service to translate num-
beric user and group ids to their correspond-
ing 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 creden-
tials assigned to this volume are used by all Macintosh
applications that make requests of this volume. These cre-
dentials 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.

MachTen Apr 27, 1995 3