Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
mount(1M)		System Administration Commands		     mount(1M)

NAME
       mount, umount - mount or	unmount	file systems and remote	resources

SYNOPSIS
       mount [-p | -v]

       mount  [-F FSType] [generic_options] [-o	specific_options] [-O] special
       | mount_point

       mount [-F FSType] [generic_options] [-o specific_options] [-O]  special
       mount_point

       mount   -a  [-F FSType]	[-V]  [current_options]	 [-o specific_options]
       [mount_point...]

       umount [-f] [-V]	[-o specific_options] special |	mount_point

       umount -a [-f] [-V] [-o specific_options] [mount_point...]

DESCRIPTION
       mount attaches a	file system  to	 the  file  system  hierarchy  at  the
       mount_point,  which  is the pathname of a directory. If mount_point has
       any contents prior to the mount operation, these	are hidden  until  the
       file system is unmounted.

       umount unmounts a currently mounted file	system,	which may be specified
       either as a mount_point or as special, the device  on  which  the  file
       system resides.

       The  table  of currently	mounted	file systems can be found by examining
       the mounted file	system information file. This is provided  by  a  file
       system  that is usually mounted on /etc/mnttab. The mounted file	system
       information is described	in mnttab(4). Mounting a file system  adds  an
       entry to	the mount table; a umount removes an entry from	the table.

       When invoked with both the special and mount_point arguments and	the -F
       option, mount validates all arguments except for	 special  and  invokes
       the  appropriate	FSType-specific	mount module. If invoked with no argu-
       ments, mount lists all the mounted file systems recorded	in  the	 mount
       table,  /etc/mnttab. If invoked with a partial argument list (with only
       one of special or mount_point, or  with	both  special  or  mount_point
       specified  but  not FSType), mount will search /etc/vfstab for an entry
       that will supply	the missing arguments. If no entry is found,  and  the
       special	argument  starts  with "/", the	default	local file system type
       specified in /etc/default/fs will be used. Otherwise the	default	remote
       file  system  type will be used.	The default remote file	system type is
       determined by the first entry  in  the  /etc/dfs/fstypes	 file.	 After
       filling	in  missing  arguments,	 mount will invoke the FSType-specific
       mount module.

       Only a super-user can mount or unmount file  systems  using  mount  and
       umount.	However,  any  user can	use mount to list mounted file systems
       and resources.

OPTIONS
       -F FSType

	   Used	to specify the FSType on which to operate. The FSType must  be
	   specified  or must be determinable from /etc/vfstab,	or by consult-
	   ing /etc/default/fs or /etc/dfs/fstypes.

       -a [ mount_points. . . ]

	   Perform mount or umount operations in parallel, when	possible.

	   If mount points are not specified, mount will mount all  file  sys-
	   tems	 whose	/etc/vfstab  "mount  at	boot" field is "yes". If mount
	   points are specified, then /etc/vfstab "mount at boot"  field  will
	   be ignored.

	   If  mount points are	specified, umount will only umount those mount
	   points. If none is specified, then umount will attempt  to  unmount
	   all file systems in /etc/mnttab, with the exception of certain sys-
	   tem required	file  systems:	/,  /usr,  /var,  /var/adm,  /var/run,
	   /proc, /dev/fd and /tmp.

       -f

	   Forcibly unmount a file system.

	   Without  this option, umount	does not allow a file system to	be un-
	   mounted if a	file on	the file system	is busy. Using this option can
	   cause  data	loss for open files; programs which access files after
	   the file system has been unmounted will get an error	(EIO).

       -p

	   Print the list of mounted file systems in the  /etc/vfstab  format.
	   Must	be the only option specified. See BUGS.

       -v

	   Print  the  list of mounted file systems in verbose format. Must be
	   the only option specified.

       -V

	   Echo	the complete command line, but do  not	execute	 the  command.
	   umount  generates a command line by using the options and arguments
	   provided by the user	and adding to them  information	 derived  from
	   /etc/mnttab.	 This option should be used to verify and validate the
	   command line.

       generic_options

	   Options that	are commonly supported by most FSType-specific command
	   modules. The	following options are available:

	   -m

	       Mount the file system without making an entry in	/etc/mnttab.

	   -g

	       Globally	 mount	the  file  system. On a	clustered system, this
	       globally	mounts the file	system on all nodes of the cluster. On
	       a non-clustered system this has no effect.

	   -o

	       Specify	FSType-specific	 options in a comma separated (without
	       spaces) list of suboptions and keyword-attribute	pairs for  in-
	       terpretation by the FSType-specific module of the command. (See
	       mount_ufs(1M).) When you	use -o with a file system that has  an
	       entry  in  /etc/vfstab, any mount options entered for that file
	       system in /etc/vfstab are ignored.

	       The following options are supported:

	       devices | nodevices

		   Allow or disallow the opening of device-special files.  The
		   default is devices.

		   If you use nosuid in	conjunction with devices, the behavior
		   is equivalent to that of nosuid.

	       exec | noexec

		   Allow or disallow executing programs	in  the	 file  system.
		   Allow  or  disallow mmap(2) with PROT_EXEC for files	within
		   the file system. The	default	is exec.

	       nbmand |	nonbmand

		   Allow or disallow non-blocking mandatory locking  semantics
		   on this file	system.	Non-blocking mandatory locking is dis-
		   allowed by default.

		   If the file system is mounted with the nbmand option,  then
		   applications	 can  use the fcntl(2) interface to place non-
		   blocking mandatory locks on files and the  system  enforces
		   those  semantics.  If  you enable this option, it can cause
		   standards conformant	applications to	see unexpected errors.

		   Do not use the nbmand option	with /,	/var and /usr.

		   You should not use the remount option to change the	nbmand
		   disposition	of the file system. The	nbmand option is mutu-
		   ally	exclusive of the global	option.	See -g.

	       ro | rw

		   Specify read-only or	read-write. The	default	is rw.

	       setuid |	nosetuid

		   Allow or disallow setuid or setgid execution.  The  default
		   is setuid.

		   If  you  specify setuid in conjunction with nosuid, the be-
		   havior is the same as nosuid.

		   nosuid is equivalent	to nosetuid and	nodevices.  When  suid
		   or  nosuid  is combined with	setuid or nosetuid and devices
		   or nodevices, the most restrictive options take effect.

		   This	option is highly recommended whenever the file	system
		   is  shared by way of	NFS with the root= option. Without it,
		   NFS clients could add setuid	programs to the	server or cre-
		   ate devices that could open security	holes.

	       suid | nosuid

		   Allow  or  disallow setuid or setgid	execution. The default
		   is suid. This option	also allows or disallows  opening  any
		   device-special entries that appear within the filesystem.

		   nosuid  is  equivalent to nosetuid and nodevices. When suid
		   or nosuid is	combined with setuid or	nosetuid  and  devices
		   or nodevices, the most restrictive options take effect.

		   This	 option	is highly recommended whenever the file	system
		   is shared using NFS with the	root=option, because,  without
		   it, NFS clients could add setuid programs to	the server, or
		   create devices that could open security holes.

	   -O

	       Overlay mount. Allow the	file system to be mounted over an  ex-
	       isting  mount point, making the underlying file system inacces-
	       sible. If a mount is attempted on a  pre-existing  mount	 point
	       without	setting	 this flag, the	mount will fail, producing the
	       error "device busy".

	   -r

	       Mount the file system read-only.

USAGE
       See largefile(5)	for the	description  of	 the  behavior	of  mount  and
       umount when encountering	files greater than or equal to 2 Gbyte ( 2**31
       bytes).

FILES
       /etc/mnttab	       Table of	mounted	file systems.

       /etc/default/fs	       Default local file system type. Default	values
			       can  be set for the following flags in /etc/de-
			       fault/fs. For example: LOCAL=ufs

			       LOCAL:	The default partition for a command if
					no FSType is specified.

       /etc/vfstab	       List  of	 default parameters for	each file sys-
			       tem.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       mount_cachefs(1M),   mount_hsfs(1M),   mount_nfs(1M),   mount_pcfs(1M),
       mount_tmpfs(1M),	 mount_ufs(1M),	mountall(1M), umountall(1M), fcntl(2),
       mmap(2),	mnttab(4), vfstab(4), attributes( 5), largefile(5), lofs(7FS),
       pcfs(7FS)

NOTES
       If  the directory on which a file system	is to be mounted is a symbolic
       link, the file system is	mounted	on the directory to which the symbolic
       link refers, rather than	on top of the symbolic link itself.

BUGS
       The mount -p output is incorrect	for cachefs.

SunOS 5.10			  1 Jul	2004			     mount(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | USAGE | FILES | ATTRIBUTES | SEE ALSO | NOTES | BUGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=mount&sektion=1m&manpath=SunOS+5.10>

home | help