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

FreeBSD Manual Pages

  
 
  

home | help
MOUNT_MSDOSFS(8)	  BSD System Manager's Manual	      MOUNT_MSDOSFS(8)

NAME
     mount_msdosfs -- mount an MS-DOS file system

SYNOPSIS
     mount_msdosfs [-o options]	[-u uid] [-g gid] [-m mask] [-M	mask] [-s]
		   [-l]	[-9] [-L locale] [-D dos-codepage] [-W table] special
		   node

DESCRIPTION
     The mount_msdosfs utility attaches	the MS-DOS file	system residing	on the
     device special to the global file system namespace	at the location	indi-
     cated by node.  This command is normally executed by mount(8) at boot
     time, but can be used by any user to mount	an MS-DOS file system on any
     directory that they own (provided,	of course, that	they have appropriate
     access to the device that contains	the file system).

     The options are as	follows:

     -o	options
	     Use the specified mount options, as described in mount(8).	 The
	     following MSDOS file system-specific options are available:

	     longnames
		     Force Windows 95 long filenames to	be visible.

	     shortnames
		     Force only	the old	MS-DOS 8.3 style filenames to be visi-
		     ble.

	     nowin95
		     Completely	ignore Windows 95 extended file	information.

     -u	uid  Set the owner of the files	in the file system to uid.  The	de-
	     fault owner is the	owner of the directory on which	the file sys-
	     tem is being mounted.

     -g	gid  Set the group of the files	in the file system to gid.  The	de-
	     fault group is the	group of the directory on which	the file sys-
	     tem is being mounted.

     -m	mask
	     Specify the maximum file permissions for files in the file	sys-
	     tem.  (For	example, a mask	of 755 specifies that, by default, the
	     owner should have read, write, and	execute	permissions for	files,
	     but others	should only have read and execute permissions.	See
	     chmod(1) for more information about octal file modes.  Only the
	     nine low-order bits of mask are used.  The	value of -M is used if
	     it	is supplied and	-m is omitted.	The default mask is taken from
	     the directory on which the	file system is being mounted.

     -M	mask
	     Specify the maximum file permissions for directories in the file
	     system.  The value	of -m is used if it is supplied	and -M is
	     omitted.  See the previous	option's description for details.

     -s	     Force behaviour to	ignore and not generate	Win'95 long filenames.

     -l	     Force listing and generation of Win'95 long filenames and sepa-
	     rate creation/modification/access dates.

	     If	neither	-s nor -l are given, mount_msdosfs searches the	root
	     directory of the file system to be	mounted	for any	existing
	     Win'95 long filenames.  If	no such	entries	are found, but short
	     DOS filenames are found, -s is the	default.  Otherwise -l is as-
	     sumed.

     -9	     Ignore the	special	Win'95 directory entries even if deleting or
	     renaming a	file.  This forces -s.

     -L	locale
	     Specify locale name used for file name conversions	for DOS	and
	     Win'95 names.  By default ISO 8859-1 assumed as local character
	     set.

     -D	dos-codepage
	     Specify the MS-DOS	code page (aka IBM/OEM code page) name used
	     for file name conversions for DOS names.

     -W	table
	     This option is remained for backward compatibility	purpose, and
	     will be removed in	the future. Please do not use this option.

	     Specify text file name with conversion table: iso22dos, iso72dos,
	     koi2dos, koi8u2dos.

EXAMPLES
     To	mount a	Russian	msdos file system located in /dev/ad1s1:

	   # mount_msdosfs -L ru_RU.KOI8-R -D CP866 /dev/ad1s1 /mnt

     To	mount a	Japanese msdos file system located in /dev/ad1s1:

	   # mount_msdosfs -L ja_JP.eucJP -D CP932 /dev/ad1s1 /mnt

SEE ALSO
     mount(2), unmount(2), fstab(5), mount(8)

     List of Localized MS Operating Systems:
     http://www.microsoft.com/globaldev/reference/oslocversion.mspx.

CAVEATS
     The use of	the -9 flag could result in damaged file systems, albeit the
     damage is in part taken care of by	procedures similar to the ones used in
     Win'95.

     FreeBSD 2.1 and earlier versions could not	handle cluster sizes larger
     than 16K.	Just mounting an MS-DOS	file system could cause	corruption to
     any mounted file system.  Cluster sizes larger than 16K are unavoidable
     for file system sizes larger than 1G, and also occur when file systems
     larger than 1G are	shrunk to smaller than 1G using	FIPS.

HISTORY
     The mount_msdosfs utility first appeared in FreeBSD 2.0.  Its predeces-
     sor, the mount_pcfs utility appeared in FreeBSD 1.0, and was abandoned in
     favor of the more aptly-named mount_msdosfs.

     The character code	conversion routine was added by	Ryuichiro Imura
     <imura@ryu16.org> at 2003.

BSD				 April 7, 1994				   BSD

NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | SEE ALSO | CAVEATS | HISTORY

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mount_msdosfs&sektion=8&manpath=FreeBSD+5.2.1-RELEASE>

home | help