home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-1.iso / NeXTanswers / Files / NEXTSTEP / Documentation / 2049_mount_manpage.txt < prev    next >
Encoding:
Text File  |  1995-10-13  |  8.5 KB  |  246 lines
  1.  
  2.  
  3. MOUNT(8)        UNIX Programmer's Manual         MOUNT(8)
  4.  
  5. NAME
  6.      mount, umount - mount and dismount filesystems
  7.  
  8. SYNOPSIS
  9.      /usr/etc/mount [ -p ]
  10.      /usr/etc/mount -a [ vd [ f | n ]] [ -t type ]
  11.      /usr/etc/mount [ -rvd [ f | n ]] [ -t type ] [ -o options ]
  12.      fsname dir
  13.      /usr/etc/mount [ -vd [ f | n ]] [ -o options ] fsname | dir
  14.  
  15.      /usr/etc/umount [ -t type ] [ -h host ]
  16.      /usr/etc/umount -a[v]
  17.      /usr/etc/umount [ -v ] fsname | dir
  18.  
  19. DESCRIPTION
  20.      The mount command attaches a filesystem fsname to the file
  21.      tree at the directory dir.  The directory dir may or may not
  22.      already exist.  If dir already exists, its contents are hid-
  23.      den until the filesystem is unmounted, and dir becomes the
  24.      name of the newly mounted root.  If fsname is of the form
  25.      host:path the filesystem type is assumed to be nfs.
  26.  
  27.      The umount command detaches the filesystem fsname previously
  28.      mounted on directory dir.    Either the filesystem name or the
  29.      mounted-on directory may be used.
  30.  
  31.      The mount and umount commands maintain a table of mounted
  32.      filesystems in /etc/mtab, described in mtab(5).  The mount
  33.      command mounts entries onto the filesystem from data it
  34.      finds in one of two places.  If NetInfo is running, it comes
  35.      from netinfo(5).  Otherwise, the entries are stored in
  36.      /etc/fstab(5).  Note that boot time mounts of type "4.3"
  37.      filesystems always occur before NetInfo is running, and so
  38.      must be stored in /etc/fstab to be seen by the system.  If
  39.      invoked without an argument, mount displays the table from
  40.      /etc/mtab.  If invoked with only one of fsname or dir mount
  41.      searches the filesystem table for an entry whose dir or
  42.      fsname field matches the given argument.  For example, if
  43.      this line is in /etc/fstab:
  44.  
  45.       /dev/sd1a /usr 4.3 rw 1 1
  46.  
  47.      then the commands mount /usr and mount /dev/sd1a are short
  48.      for mount /dev/sd1a /usr
  49.  
  50. MOUNT OPTIONS
  51.      -p   Print the list of mounted filesystems in a format suit-
  52.       able for use in /etc/fstab.
  53.  
  54.      -a   Attempt to mount all the filesystems described in the
  55.       filesystem table.  (In this case, fsname and dir are
  56.       taken from the filesystem table.) If a type is
  57.       specified all of the filesystems in the filesystem
  58.       table with that type are mounted.  Filesystems are not
  59.       necessarily mounted in the order listed in the table.
  60.  
  61.      -f   Fake a new /etc/mtab entry, but do not actually mount
  62.       any filesystems.
  63.  
  64.      -n   Mount the filesystems without updating /etc/mtab.
  65.       (This can be useful for recovering from an overly full
  66.       disk.)
  67.  
  68.      -v   Verbose - mount displays a message indicating the
  69.       filesystem being mounted.
  70.  
  71.      -d   Don't check if NFS mount appears to be mounting a
  72.       directory on top of itself.  Otherwise, mount ignores
  73.       such requests.  Since the NFS daemon on a machine might
  74.       not have the same filesystem root as the mount process,
  75.       this option may be necessary in a chroot'ed environ-
  76.       ment.
  77.  
  78.      -t   The next argument is the filesystem type.  The accepted
  79.       types are 4.3, nfs, dos, macintosh, nucfs (NetWare UNIX
  80.       Client file system), and cfs (CD-ROM file system).  See
  81.       fstab(5) for a description of these filesystem types.
  82.  
  83.      -r   Mount the specified filesystem read-only.  This is
  84.       short for:
  85.  
  86.            mount -o ro fsname dir
  87.  
  88.       Physically write-protected and magnetic tape filesys-
  89.       tems must be mounted read-only, or errors occur when
  90.       access times are updated whether or not any explicit
  91.       write is attempted.
  92.  
  93.      -o   Specify options, a list of comma-separated words from
  94.       the list below.  Some options are valid for all
  95.       filesystem types, while others apply to a specific type
  96.       only.
  97.  
  98.       The following is a list of options valid on all file
  99.       systems (the default is rw,suid if the filesystem is
  100.       mounted by root and rw,nosuid if the filesystem is not
  101.       mounted by root):
  102.  
  103.       rw     read/write.
  104.  
  105.       ro     read-only.
  106.  
  107.       suid     set-uid execution allowed (cannot be specified;
  108.          default if root mounts the filesystem).
  109.  
  110.       nosuid set-uid execution not allowed.
  111.  
  112.       noauto do not mount this file system automatically
  113.          (mount -a).
  114.  
  115.       remountchange the mount options on this file system
  116.          without unmounting it first.
  117.  
  118.       options specific to nfs (NFS) file systems.  The
  119.       defaults are:
  120.            fg,mnttimeo=20,retry=1,timeo=7,retrans=3,port=NFS_PORT,hard
  121.       The defaults for rsize and wsize set by the kernel.
  122.  
  123.       bg     if the first mount attempt fails, retry in the
  124.          background.
  125.  
  126.       fg     retry in foreground.
  127.  
  128.       mnttimeo=n
  129.          set mount timeout to n seconds.
  130.  
  131.       retry=nset number times to retry mount to n.
  132.  
  133.       rsize=nset read buffer size to n bytes.
  134.  
  135.       wsize=nset write buffer size to n bytes.
  136.  
  137.       timeo=nset NFS timeout to n tenths of a second.
  138.  
  139.       retrans=n
  140.          set number of NFS retransmissions to n.
  141.  
  142.       port=n set server IP port number to n.
  143.  
  144.       soft     return error if server doesn't respond. Do not
  145.          use this option with the rw option.
  146.  
  147.       hard     retry request until server responds.
  148.  
  149.       intr     allow keyboard interrupts on hard mounts.
  150.  
  151.       net     Tell the NFS automounter to recognize this as a
  152.          "network" mount.  The mount command will ignore
  153.          these entries and allow the autonfsmount(8) to
  154.          take care of them.  This option allows one to
  155.          create a uniform view of the network from all
  156.          machines.  Typically, the mount point specified
  157.          is "/Net".  A mount of the form "mount -o net
  158.          MACHINE:PATH /Net" translates to "mount
  159.          MACHINE:PATH /Net/MACHINE/PATH".  If the mount
  160.          is performed on the machine serving the file
  161.          system, then no actual mount occurs.  Instead, a
  162.          symbolic link is created from "/Net/MACHINE" to
  163.          "/".
  164.  
  165.       acregmin=n
  166.          set minimum time interval (in seconds) for file
  167.          entry caching
  168.  
  169.       acregmax=n
  170.          set maximum time interval (in seconds) for file
  171.          entry caching
  172.  
  173.       acdirmin=n
  174.          set minimum time interval for directory entry
  175.          caching
  176.  
  177.       acdirmax=n
  178.          set maximum time interval for directory entry
  179.          caching
  180.  
  181.       noac     set no file attribute caching
  182.  
  183.       The bg option causes mount to run in the background if
  184.       the server's mountd(8) does not respond. mount attempts
  185.       each request retry=n times before giving up.    Once the
  186.       filesystem is mounted, each NFS request made in the
  187.       kernel waits timeo=n tenths of a second for a response.
  188.       If no response arrives, the time-out is multiplied by 2
  189.       and the request is retransmitted.  When retrans=n
  190.       retransmissions have been sent with no reply a soft
  191.       mounted filesystem returns an error on the request and
  192.       a hard mounted filesystem prints a message and retries
  193.       the request.    Filesystems that are mounted rw (read-
  194.       write) should use the hard option.  The intr option
  195.       allows keyboard interrupts to kill a process that is
  196.       hung waiting for a response on a hard mounted filesys-
  197.       tem.    The number of bytes in a read or write request
  198.       can be set with the rsize and wsize options.
  199.  
  200.      The attribute caching options can be used to defeat or
  201.      modify client-side caching of attributes relating to objects
  202.      accessed via NFS from a server.  Changing these options can
  203.      have a severe impact on the client-side performance of an
  204.      NFS filesystem.  A typical scenario where changing the
  205.      parameters is beneficial is a multi-workstation development
  206.      environment, where multiple clients are performing
  207.      read/write file access to a common source file set.
  208.  
  209. UMOUNT OPTIONS
  210.      -h host
  211.       Unmount all filesystems listed in /etc/mtab that are
  212.       remote-mounted from host.
  213.  
  214.      -a   Attempt to unmount all the filesystems currently
  215.       mounted (listed in /etc/mtab).  In this case, fsname is
  216.       taken from /etc/mtab.
  217.  
  218.      -v   Verbose - umount displays a message indicating the
  219.       filesystem being unmounted.
  220.  
  221. EXAMPLES
  222.      mount /dev/sd1a /usr            mount a local disk
  223.      mount -ft 4.3 /dev/nd0 /            fake an entry for nd root
  224.      mount -at 4.3                mount all 4.3 filesystems
  225.      mount -t nfs serv:/usr/src /usr/src    mount remote filesystem
  226.      mount serv:/usr/src /usr/src        same as above
  227.      mount -o hard serv:/usr/src /usr/src   same as above but hard mount
  228.      mount -p > /etc/fstab            save current mount state
  229.  
  230. FILES
  231.      /etc/mtab table of mounted filesystems
  232.      /etc/fstab     table of filesystems mounted at boot
  233.  
  234. SEE ALSO
  235.      mount(2), unmount(2), fstab(5), mountd(8C), nfsd(8C),
  236.      netinfo(5)
  237.  
  238. BUGS
  239.      Mounting filesystems full of garbage crashes the system.
  240.  
  241.      If the directory on which a filesystem is to be mounted is a
  242.      symbolic link, the filesystem is mounted on the directory to
  243.      which the symbolic link refers, rather than being mounted on
  244.      top of the symbolic link itself.
  245.  
  246.