]> git.ipfire.org Git - thirdparty/util-linux.git/blob - mount/mount.8
Imported from util-linux-2.10s tarball.
[thirdparty/util-linux.git] / mount / mount.8
1 .\" Copyright (c) 1996 Andries Brouwer
2 .\"
3 .\" This page is somewhat derived from a page that was
4 .\" (c) 1980, 1989, 1991 The Regents of the University of California
5 .\" and had been heavily modified by Rik Faith and myself.
6 .\" (Probably no BSD text remains.)
7 .\" Fragments of text were written by Werner Almesberger, Remy Card,
8 .\" Stephen Tweedie and Eric Youngdale.
9 .\"
10 .\" This is free documentation; you can redistribute it and/or
11 .\" modify it under the terms of the GNU General Public License as
12 .\" published by the Free Software Foundation; either version 2 of
13 .\" the License, or (at your option) any later version.
14 .\"
15 .\" The GNU General Public License's references to "object code"
16 .\" and "executables" are to be interpreted as the output of any
17 .\" document formatting or typesetting system, including
18 .\" intermediate and printed output.
19 .\"
20 .\" This manual is distributed in the hope that it will be useful,
21 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
22 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
23 .\" GNU General Public License for more details.
24 .\"
25 .\" You should have received a copy of the GNU General Public
26 .\" License along with this manual; if not, write to the Free
27 .\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
28 .\" USA.
29 .\"
30 .\" 960705, aeb: version for mount-2.7g
31 .\" 970114, aeb: xiafs and ext are dead; romfs is new
32 .\" 970623, aeb: -F option
33 .\" 970914, reg: -s option
34 .\" 981111, K.Garloff: /etc/filesystems
35 .\" 990111, aeb: documented /sbin/mount.smbfs
36 .\" 990730, Yann Droneaud <lch@multimania.com>: updated page
37 .\" 991214, Elrond <Elrond@Wunder-Nett.org>: added some docs on devpts
38 .\"
39 .TH MOUNT 8 "14 September 1997" "Linux 2.0" "Linux Programmer's Manual"
40 .SH NAME
41 mount \- mount a file system
42 .SH SYNOPSIS
43 .BI "mount [\-lhV]"
44 .LP
45 .BI "mount \-a [\-fFnrsvw] [\-t " vfstype ]
46 .br
47 .BI "mount [\-fnrsvw] [\-o " options " [,...]] " "device " | " dir"
48 .br
49 .BI "mount [\-fnrsvw] [\-t " vfstype "] [\-o " options "] " "device dir"
50 .SH DESCRIPTION
51 All files accessible in a Unix system are arranged in one big
52 tree, the file hierarchy, rooted at
53 .BR / .
54 These files can be spread out over several devices. The
55 .B mount
56 command serves to attach the file system found on some device
57 to the big file tree. Conversely, the
58 .BR umount (8)
59 command will detach it again.
60
61 The standard form of the
62 .B mount
63 command, is
64 .RS
65 .br
66 .BI "mount \-t" " type device dir"
67 .RE
68 This tells the kernel to attach the file system found on
69 .I device
70 (which is of type
71 .IR type )
72 at the directory
73 .IR dir .
74 The previous contents (if any) and owner and mode of
75 .I dir
76 become invisible, and as long as this file system remains mounted,
77 the pathname
78 .I dir
79 refers to the root of the file system on
80 .IR device .
81
82 Three forms of invocation do not actually mount anything:
83 .RS
84 .br
85 .B "mount \-h"
86 .RE
87 prints a help message;
88 .RS
89 .br
90 .B "mount \-V"
91 .RE
92 prints a version string; and just
93 .RS
94 .BI "mount [-l] [-t" " type" ]
95 .RE
96 lists all mounted file systems (of type
97 .IR type ).
98 The option \-l adds the (ext2) labels in this listing.
99 See below.
100
101 .\" In fact since 2.3.99. At first the syntax was mount -t bind.
102 Since Linux 2.4.0 it is possible to remount part of the
103 file hierarchy somewhere else. The call is
104 .RS
105 .br
106 .B "mount --bind olddir newdir"
107 .RE
108
109 The
110 .I proc
111 file system is not associated with a special device, and when
112 mounting it, an arbitrary keyword, such as
113 .I proc
114 can be used instead of a device specification.
115 (The customary choice
116 .I none
117 is less fortunate: the error message `none busy' from
118 .B umount
119 can be confusing.)
120
121 Most devices are indicated by a file name (of a block special device), like
122 .IR /dev/sda1 ,
123 but there are other possibilities. For example, in the case of an NFS mount,
124 .I device
125 may look like
126 .IR knuth.cwi.nl:/dir .
127 It is possible to indicate a block special device using its
128 volume label or UUID (see the \-L and \-U options below).
129
130 The file
131 .I /etc/fstab
132 (see
133 .BR fstab (5)),
134 may contain lines describing what devices are usually
135 mounted where, using which options. This file is used in three ways:
136 .LP
137 (i) The command
138 .RS
139 .br
140 .BI "mount \-a [-t" " type" ]
141 .RE
142 (usually given in a bootscript) causes all file systems mentioned in
143 .I fstab
144 (of the proper type) to be mounted as indicated, except for those
145 whose line contains the
146 .B noauto
147 keyword. Adding the
148 .B \-F
149 option will make mount fork, so that the
150 filesystems are mounted simultaneously.
151 .LP
152 (ii) When mounting a file system mentioned in
153 .IR fstab ,
154 it suffices to give only the device, or only the mount point.
155 .LP
156 (iii) Normally, only the superuser can mount file systems.
157 However, when
158 .I fstab
159 contains the
160 .B user
161 option on a line, then anybody can mount the corresponding system.
162 .LP
163 Thus, given a line
164 .RS
165 .br
166 .B "/dev/cdrom /cd iso9660 ro,user,noauto,unhide"
167 .RE
168 any user can mount the iso9660 file system found on his CDROM
169 using the command
170 .RS
171 .br
172 .B "mount /dev/cdrom"
173 .RE
174 or
175 .RS
176 .br
177 .B "mount /cd"
178 .RE
179 For more details, see
180 .BR fstab (5).
181 Only the user that mounted a filesystem can unmount it again.
182 If any user should be able to unmount, then use
183 .B users
184 instead of
185 .B user
186 in the
187 .I fstab
188 line.
189 The
190 .B owner
191 option is similar to the
192 .B user
193 option, with the restriction that the user must be the owner
194 of the special file. This may be useful e.g. for
195 .I /dev/fd
196 if a login script makes the console user owner of this device.
197
198 The programs
199 .B mount
200 and
201 .B umount
202 maintain a list of currently mounted file systems in the file
203 .IR /etc/mtab .
204 If no arguments are given to
205 .BR mount ,
206 this list is printed.
207 When the
208 .I proc
209 filesystem is mounted (say at
210 .IR /proc ),
211 the files
212 .I /etc/mtab
213 and
214 .I /proc/mounts
215 have very similar contents. The former has somewhat
216 more information, such as the mount options used,
217 but is not necessarily up-to-date (cf. the
218 .B \-n
219 option below). It is possible to replace
220 .I /etc/mtab
221 by a symbolic link to
222 .IR /proc/mounts ,
223 but some information is lost that way, and in particular
224 working with the loop device will be less convenient. Also,
225 pathnames containing spaces are handled correctly by
226 .I /etc/mtab
227 but not (yet) by
228 .IR /proc/mounts .
229
230 .SH OPTIONS
231 The full set of options used by an invocation of
232 .B mount
233 is determined by first extracting the
234 options for the file system from the
235 .I fstab
236 table, then applying any options specified by the
237 .B \-o
238 argument, and finally applying a
239 .BR \-r " or " \-w
240 option, when present.
241
242 Options available for the
243 .B mount
244 command:
245 .TP
246 .B \-V
247 Output version.
248 .TP
249 .B \-h
250 Print a help message.
251 .TP
252 .B \-v
253 Verbose mode.
254 .TP
255 .B \-a
256 Mount all filesystems (of the given types) mentioned in
257 .IR fstab .
258 .TP
259 .B \-F
260 (Used in conjunction with
261 .BR \-a .)
262 Fork off a new incarnation of mount for each device.
263 This will do the mounts on different devices or different NFS servers
264 in parallel.
265 This has the advantage that it is faster; also NFS timeouts go in
266 parallel. A disadvantage is that the mounts are done in undefined order.
267 Thus, you cannot use this option if you want to mount both
268 .I /usr
269 and
270 .IR /usr/spool .
271 .TP
272 .B \-f
273 Causes everything to be done except for the actual system call; if it's not
274 obvious, this ``fakes'' mounting the file system. This option is useful in
275 conjunction with the
276 .B \-v
277 flag to determine what the
278 .B mount
279 command is trying to do. It can also be used to add entries for devices
280 that were mounted earlier with the -n option.
281 .TP
282 .B \-l
283 Add the ext2 labels in the mount output. Mount must have permission to
284 read the disk device (e.g. be suid root) for this to work.
285 One can set such a label
286 using the
287 .BR e2label (8)
288 utility.
289 .TP
290 .B \-n
291 Mount without writing in
292 .IR /etc/mtab .
293 This is necessary for example when
294 .I /etc
295 is on a read-only file system.
296 .TP
297 .B \-s
298 Tolerate sloppy mount options rather than failing. This will ignore
299 mount options not supported by a filesystem type. Not all filesystems
300 support this option. This option exists for support of the Linux
301 autofs\-based automounter.
302 .TP
303 .B \-r
304 Mount the file system read-only. A synonym is
305 .BR "\-o ro" .
306 .TP
307 .B \-w
308 Mount the file system read/write. This is the default. A synonym is
309 .BR "\-o rw" .
310 .TP
311 .BI \-L " label"
312 Mount the partition that has the specified
313 .IR label .
314 .TP
315 .BI \-U " uuid"
316 Mount the partition that has the specified
317 .IR uuid .
318 These two options require the file
319 .I /proc/partitions
320 (present since Linux 2.1.116) to exist.
321 .TP
322 .BI \-t " vfstype"
323 The argument following the
324 .B \-t
325 is used to indicate the file system type. The file system types which are
326 currently supported are listed in
327 .IR linux/fs/filesystems.c :
328 .IR adfs ,
329 .IR affs ,
330 .IR autofs ,
331 .IR coda ,
332 .IR coherent ,
333 .IR devpts ,
334 .IR efs ,
335 .IR ext ,
336 .IR ext2 ,
337 .IR hfs ,
338 .IR hpfs ,
339 .IR iso9660 ,
340 .IR minix ,
341 .IR msdos ,
342 .IR ncpfs ,
343 .IR nfs ,
344 .IR ntfs ,
345 .IR proc ,
346 .IR qnx4 ,
347 .IR romfs ,
348 .IR smbfs ,
349 .IR sysv ,
350 .IR udf ,
351 .IR ufs ,
352 .IR umsdos ,
353 .IR vfat ,
354 .IR xenix ,
355 .IR xiafs .
356 Note that coherent, sysv and xenix are equivalent and that
357 .I xenix
358 and
359 .I coherent
360 will be removed at some point in the future \(em use
361 .I sysv
362 instead. Since kernel version 2.1.21 the types
363 .I ext
364 and
365 .I xiafs
366 do not exist anymore.
367
368 For most types all the
369 .B mount
370 program has to do is issue a simple
371 .IR mount (2)
372 system call, and no detailed knowledge of the filesystem type is required.
373 For a few types however (like nfs, smbfs, ncpfs) ad hoc code is
374 necessary. The nfs ad hoc code is built in, but smbfs and ncpfs
375 have a separate mount program. In order to make it possible to
376 treat all types in a uniform way, mount will execute the program
377 .I /sbin/mount.TYPE
378 (if that exists) when called with type
379 .IR TYPE .
380 Since various versions of the
381 .I smbmount
382 program have different calling conventions,
383 .I /sbin/mount.smb
384 may have to be a shell script that sets up the desired call.
385
386 The type
387 .I iso9660
388 is the default. If no
389 .B \-t
390 option is given, or if the
391 .B auto
392 type is specified, the superblock is probed for the filesystem type
393 .RI ( minix ", " ext ", " ext2 ", " xiafs ", " iso9660 ", " romfs
394 .RI , ufs ", " ntfs ", " qnx4 ", " bfs
395 are supported).
396 If this probe fails, mount will try to read the file
397 .IR /etc/filesystems ,
398 or, if that does not exist,
399 .IR /proc/filesystems .
400 All of the filesystem types listed there will be tried,
401 except for those that are labeled "nodev" (e.g.,
402 .IR devpts ,
403 .I proc
404 and
405 .IR nfs ).
406
407 Note that the
408 .B auto
409 type may be useful for user-mounted floppies.
410 Creating a file
411 .I /etc/filesystems
412 can be useful to change the probe order (e.g., to try vfat before msdos)
413 or if you use a kernel module autoloader.
414 Warning: the probing uses a heuristic (the presence of appropriate `magic'),
415 and could recognize the wrong filesystem type.
416
417 More than one type may be specified in a comma separated
418 list. The list of file system types can be prefixed with
419 .B no
420 to specify the file system types on which no action should be taken.
421 (This can be meaningful with the
422 .B \-a
423 option.)
424
425 For example, the command:
426 .RS
427 .RS
428 .B "mount \-a \-t nomsdos,ext"
429 .RE
430 mounts all file systems except those of type
431 .I msdos
432 and
433 .IR ext .
434 .RE
435 .TP
436 .B \-o
437 Options are specified with a
438 .B \-o
439 flag followed by a comma separated string of options.
440 Some of these options are only useful when they appear in the
441 .I /etc/fstab
442 file. The following options apply to any file system that is being
443 mounted:
444 .RS
445 .TP
446 .B async
447 All I/O to the file system should be done asynchronously.
448 .TP
449 .B atime
450 Update inode access time for each access. This is the default.
451 .TP
452 .B auto
453 Can be mounted with the
454 .B \-a
455 option.
456 .TP
457 .B defaults
458 Use default options:
459 .BR rw ", " suid ", " dev ", " exec ", " auto ", " nouser ", and " async.
460 .TP
461 .B dev
462 Interpret character or block special devices on the file system.
463 .TP
464 .B exec
465 Permit execution of binaries.
466 .TP
467 .B noatime
468 Do not update inode access times on this file system (e.g, for faster
469 access on the news spool to speed up news servers).
470 .TP
471 .B noauto
472 Can only be mounted explicitly (i.e., the
473 .B \-a
474 option will not cause the file system to be mounted).
475 .TP
476 .B nodev
477 Do not interpret character or block special devices on the file
478 system.
479 .TP
480 .B noexec
481 Do not allow execution of any binaries on the mounted file system.
482 This option might be useful for a server that has file systems containing
483 binaries for architectures other than its own.
484 .TP
485 .B nosuid
486 Do not allow set-user-identifier or set-group-identifier bits to take
487 effect. (This seems safe, but is in fact rather unsafe if you have
488 suidperl(1) installed.)
489 .TP
490 .B nouser
491 Forbid an ordinary (i.e., non-root) user to mount the file system.
492 This is the default.
493 .TP
494 .B remount
495 Attempt to remount an already-mounted file system. This is commonly
496 used to change the mount flags for a file system, especially to make a
497 readonly file system writeable.
498 .TP
499 .B ro
500 Mount the file system read-only.
501 .TP
502 .B rw
503 Mount the file system read-write.
504 .TP
505 .B suid
506 Allow set-user-identifier or set-group-identifier bits to take
507 effect.
508 .TP
509 .B sync
510 All I/O to the file system should be done synchronously.
511 .TP
512 .B user
513 Allow an ordinary user to mount the file system. This option implies
514 the options
515 .BR noexec ", " nosuid ", and " nodev
516 (unless overridden by subsequent options, as in the option line
517 .BR user,exec,dev,suid ).
518 .RE
519
520 .SH "FILESYSTEM SPECIFIC MOUNT OPTIONS"
521 The following options apply only to certain file systems.
522 We sort them by file system. They all follow the
523 .B \-o
524 flag.
525
526 .SH "Mount options for affs"
527 .TP
528 \fBuid=\fP\fIvalue\fP and \fBgid=\fP\fIvalue\fP
529 Set the owner and group of the root of the file system (default: uid=gid=0,
530 but with option
531 .B uid
532 or
533 .B gid
534 without specified value, the uid and gid of the current process are taken).
535 .TP
536 \fBsetuid=\fP\fIvalue\fP and \fBsetgid=\fP\fIvalue\fP
537 Set the owner and group of all files.
538 .TP
539 .BI mode= value
540 Set the mode of all files to
541 .IR value " & 0777"
542 disregarding the original permissions.
543 Add search permission to directories that have read permission.
544 The value is given in octal.
545 .TP
546 .B protect
547 Do not allow any changes to the protection bits on the file system.
548 .TP
549 .B usemp
550 Set uid and gid of the root of the file system to the uid and gid
551 of the mount point upon the first sync or umount, and then
552 clear this option. Strange...
553 .TP
554 .B verbose
555 Print an informational message for each successful mount.
556 .TP
557 .BI prefix= string
558 Prefix used before volume name, when following a link.
559 .TP
560 .BI volume= string
561 Prefix (of length at most 30) used before '/' when following a symbolic link.
562 .TP
563 .BI reserved= value
564 (Default: 2.) Number of unused blocks at the start of the device.
565 .TP
566 .BI root= value
567 Give explicitly the location of the root block.
568 .TP
569 .BI bs= value
570 Give blocksize. Allowed values are 512, 1024, 2048, 4096.
571 .TP
572 .BR grpquota " / " noquota " / " quota " / " usrquota
573 These options are accepted but ignored.
574
575 .SH "Mount options for coherent"
576 None.
577
578 .SH "Mount options for devpts"
579 The devpts file system is a pseudo file system, traditionally mounted on
580 .IR /dev/pts .
581 In order to acquire a pseudo terminal, a process opens
582 .IR /dev/ptmx ;
583 the number of the pseudo terminal is then made available to the process
584 and the pseudo terminal slave can be accessed as
585 .IR /dev/pts/ <number>.
586 .TP
587 \fBuid=\fP\fIvalue\fP and \fBgid=\fP\fIvalue\fP
588 This sets the owner or the group of newly created PTYs to
589 the specified values. When nothing is specified, they will
590 be set to the UID and GID of the creating process.
591 For example, if there is a tty group with GID 5, then
592 .B gid=5
593 will cause newly created PTYs to belong to the tty group.
594 .TP
595 .BI mode= value
596 Set the mode of newly created PTYs to the specified value.
597 The default is 0600.
598 A value of
599 .B mode=620
600 and
601 .B gid=5
602 makes "mesg y" the default on newly created PTYs.
603
604 .SH "Mount options for ext"
605 None.
606 Note that the `ext' file system is obsolete. Don't use it.
607 Since Linux version 2.1.21 extfs is no longer part of the kernel source.
608
609 .SH "Mount options for ext2"
610 The `ext2' file system is the standard Linux file system.
611 Due to a kernel bug, it may be mounted with random mount options
612 (fixed in Linux 2.0.4).
613 .TP
614 .BR bsddf " / " minixdf
615 Set the behaviour for the
616 .I statfs
617 system call. The
618 .B minixdf
619 behaviour is to return in the
620 .I f_blocks
621 field the total number of blocks of the file system, while the
622 .B bsddf
623 behaviour (which is the default) is to subtract the overhead blocks
624 used by the ext2 file system and not available for file storage. Thus
625 .RE
626 .nf
627
628 % mount /k -o minixdf; df /k; umount /k
629 Filesystem 1024-blocks Used Available Capacity Mounted on
630 /dev/sda6 2630655 86954 2412169 3% /k
631 % mount /k -o bsddf; df /k; umount /k
632 Filesystem 1024-blocks Used Available Capacity Mounted on
633 /dev/sda6 2543714 13 2412169 0% /k
634
635 .fi
636 (Note that this example shows that one can add command line options
637 to the options given in
638 .IR /etc/fstab .)
639
640 .TP
641 .BR check " / " check=normal " / " check=strict
642 Set checking level. When at least one of these options is set (and
643 .B check=normal
644 is set by default) the inodes and blocks bitmaps are checked upon mount
645 (which can take half a minute or so on a big disk, and is rather useless).
646 With strict checking, block deallocation checks that the block to free
647 is in the data zone.
648 .TP
649 .BR check=none " / " nocheck
650 No checking is done. This is fast. Recent kernels do not have a
651 check option anymore - checking with
652 .BR e2fsck (8)
653 is more meaningful.
654 .TP
655 .B debug
656 Print debugging info upon each (re)mount.
657 .TP
658 .BR errors=continue " / " errors=remount-ro " / " errors=panic
659 Define the behaviour when an error is encountered.
660 (Either ignore errors and just mark the file system erroneous and continue,
661 or remount the file system read-only, or panic and halt the system.)
662 The default is set in the filesystem superblock, and can be
663 changed using
664 .BR tune2fs (8).
665 .TP
666 .BR grpid " or " bsdgroups " / " nogrpid " or " sysvgroups
667 These options define what group id a newly created file gets.
668 When
669 .BR grpid
670 is set, it takes the group id of the directory in which it is created;
671 otherwise (the default) it takes the fsgid of the current process, unless
672 the directory has the setgid bit set, in which case it takes the gid
673 from the parent directory, and also gets the setgid bit set
674 if it is a directory itself.
675 .TP
676 \fBresgid=\fP\fIn\fP and \fBresuid=\fP\fIn\fP
677 The ext2 file system reserves a certain percentage of the available
678 space (by default 5%, see
679 .BR mke2fs (8)
680 and
681 .BR tune2fs (8)).
682 These options determine who can use the reserved blocks.
683 (Roughly: whoever has the specified uid, or belongs to the specified group.)
684 .TP
685 .BI sb= n
686 Instead of block 1, use block
687 .I n
688 as superblock. This could be useful when the filesystem has been damaged.
689 (Earlier, copies of the superblock would be made every 8192 blocks: in
690 block 1, 8193, 16385, ... (and one got hundreds or even thousands
691 of copies on a big filesystem). Since version 1.08,
692 .B mke2fs
693 has a \-s (sparse superblock) option to reduce the number of backup
694 superblocks, and since version 1.15 this is the default. Note
695 that this may mean that ext2 filesystems created by a recent
696 .B mke2fs
697 cannot be mounted r/w under Linux 2.0.*.)
698 .TP
699 .BR grpquota " / " noquota " / " quota " / " usrquota
700 These options are accepted but ignored.
701
702 .SH "Mount options for fat"
703 (Note:
704 .I fat
705 is not a separate filesystem, but a common part of the
706 .IR msdos ,
707 .I umsdos
708 and
709 .I vfat
710 filesystems.)
711 .TP
712 .BR blocksize=512 " / " blocksize=1024 " / " blocksize=2048
713 Set blocksize (default 512).
714 .TP
715 \fBuid=\fP\fIvalue\fP and \fBgid=\fP\fIvalue\fP
716 Set the owner and group of all files. (Default: the uid and gid
717 of the current process.)
718 .TP
719 .BI umask= value
720 Set the umask (the bitmask of the permissions that are
721 .B not
722 present). The default is the umask of the current process.
723 The value is given in octal.
724 .TP
725 .BI check= value
726 Three different levels of pickyness can be chosen:
727 .RS
728 .TP
729 .B r[elaxed]
730 Upper and lower case are accepted and equivalent, long name parts are
731 truncated (e.g.
732 .I verylongname.foobar
733 becomes
734 .IR verylong.foo ),
735 leading and embedded spaces are accepted in each name part (name and extension).
736 .TP
737 .B n[ormal]
738 Like "relaxed", but many special characters (*, ?, <, spaces, etc.) are
739 rejected. This is the default.
740 .TP
741 .B s[trict]
742 Like "normal", but names may not contain long parts and special characters
743 that are sometimes used on Linux, but are not accepted by MS-DOS are
744 rejected. (+, =, spaces, etc.)
745 .RE
746 .TP
747 .BI codepage= value
748 Sets the codepage for converting to shortname characters on FAT
749 and VFAT filesystems. By default, codepage 437 is used.
750 .TP
751 .BR conv=b[inary] " / " conv=t[ext] " / " conv=a[uto]
752 The
753 .I fat
754 file system can perform CRLF<-->NL (MS-DOS text format to UNIX text
755 format) conversion in the kernel. The following conversion modes are
756 available:
757 .RS
758 .TP
759 .B binary
760 no translation is performed. This is the default.
761 .TP
762 .B text
763 CRLF<-->NL translation is performed on all files.
764 .TP
765 .B auto
766 CRLF<-->NL translation is performed on all files that don't have a
767 "well-known binary" extension. The list of known extensions can be found at
768 the beginning of
769 .I fs/fat/misc.c
770 (as of 2.0, the list is: exe, com, bin, app, sys, drv, ovl, ovr, obj,
771 lib, dll, pif, arc, zip, lha, lzh, zoo, tar, z, arj, tz, taz, tzp, tpz,
772 gz, tgz, deb, gif, bmp, tif, gl, jpg, pcx, tfm, vf, gf, pk, pxl, dvi).
773 .PP
774 Programs that do computed lseeks won't like in-kernel text conversion.
775 Several people have had their data ruined by this translation. Beware!
776
777 For file systems mounted in binary mode, a conversion tool
778 (fromdos/todos) is available.
779 .RE
780 .TP
781 .BI cvf_format= module
782 Forces the driver to use the CVF (Compressed Volume File) module
783 .RI cvf_ module
784 instead of auto-detection. If the kernel supports kmod, the
785 cvf_format=xxx option also controls on-demand CVF module loading.
786 .TP
787 .BI cvf_option= option
788 Option passed to the CVF module.
789 .TP
790 .B debug
791 Turn on the
792 .I debug
793 flag. A version string and a list of file system parameters will be
794 printed (these data are also printed if the parameters appear to be
795 inconsistent).
796 .TP
797 .BR fat=12 " / " fat=16 " / " fat=32
798 Specify a 12, 16 or 32 bit fat. This overrides
799 the automatic FAT type detection routine. Use with caution!
800 .TP
801 .BI iocharset= value
802 Character set to use for converting between 8 bit characters
803 and 16 bit Unicode characters. The default is iso8859-1.
804 Long filenames are stored on disk in Unicode format.
805 .TP
806 .B quiet
807 Turn on the
808 .I quiet
809 flag. Attempts to chown or chmod files do not return errors,
810 although they fail. Use with caution!
811 .TP
812 .B "sys_immutable, showexec, dots, nodots, dotsOK=[yes|no]"
813 Various misguided attempts to force Unix or DOS conventions
814 onto a FAT file system.
815
816 .SH "Mount options for hpfs"
817 .TP
818 \fBuid=\fP\fIvalue\fP and \fBgid=\fP\fIvalue\fP
819 Set the owner and group of all files. (Default: the uid and gid
820 of the current process.)
821 .TP
822 .BI umask= value
823 Set the umask (the bitmask of the permissions that are
824 .B not
825 present). The default is the umask of the current process.
826 The value is given in octal.
827 .TP
828 .BR case=lower " / " case=asis
829 Convert all files names to lower case, or leave them.
830 (Default:
831 .BR case=lower .)
832 .TP
833 .BR conv=binary " / " conv=text " / " conv=auto
834 For
835 .BR conv=text ,
836 delete some random CRs (in particular, all followed by NL)
837 when reading a file.
838 For
839 .BR conv=auto ,
840 choose more or less at random between
841 .BR conv=binary " and " conv=text .
842 For
843 .BR conv=binary ,
844 just read what is in the file. This is the default.
845 .TP
846 .B nocheck
847 Do not abort mounting when certain consistency checks fail.
848
849 .SH "Mount options for iso9660"
850 Normal
851 .I iso9660
852 filenames appear in a 8.3 format (i.e., DOS-like restrictions on filename
853 length), and in addition all characters are in upper case. Also there is
854 no field for file ownership, protection, number of links, provision for
855 block/character devices, etc.
856
857 Rock Ridge is an extension to iso9660 that provides all of these unix like
858 features. Basically there are extensions to each directory record that
859 supply all of the additional information, and when Rock Ridge is in use,
860 the filesystem is indistinguishable from a normal UNIX file system (except
861 that it is read-only, of course).
862 .TP
863 .B norock
864 Disable the use of Rock Ridge extensions, even if available. Cf.\&
865 .BR map .
866 .B nojoliet
867 Disable the use of Microsoft Joliet extensions, even if available. Cf.\&
868 .BR map .
869 .TP
870 .BR check=r[elaxed] " / " check=s[trict]
871 With
872 .BR check=relaxed ,
873 a filename is first converted to lower case before doing the lookup.
874 This is probably only meaningful together with
875 .B norock
876 and
877 .BR map=normal .
878 (Default:
879 .BR check=strict .)
880 .TP
881 \fBuid=\fP\fIvalue\fP and \fBgid=\fP\fIvalue\fP
882 Give all files in the file system the indicated user or group id,
883 possibly overriding the information found in the Rock Ridge extensions.
884 (Default:
885 .BR uid=0,gid=0 .)
886 .TP
887 .BR map=n[ormal] " / " map=o[ff] " / " map=a[corn]
888 For non-Rock Ridge volumes, normal name translation maps upper
889 to lower case ASCII, drops a trailing `;1', and converts `;' to `.'.
890 With
891 .B map=off
892 no name translation is done. See
893 .BR norock .
894 (Default:
895 .BR map=normal .)
896 .B map=acorn
897 is like
898 .BR map=normal
899 but also apply Acorn extensions if present.
900 .TP
901 .BI mode= value
902 For non-Rock Ridge volumes, give all files the indicated mode.
903 (Default: read permission for everybody.)
904 Since Linux 2.1.37 one no longer needs to specify the mode in
905 decimal. (Octal is indicated by a leading 0.)
906 .TP
907 .B unhide
908 Also show hidden and associated files.
909 .TP
910 .B block=[512|1024|2048]
911 Set the block size to the indicated value.
912 (Default:
913 .BR block=1024 .)
914 .TP
915 .BR conv=a[uto] " / " conv=b[inary] " / " conv=m[text] " / " conv=t[ext]
916 (Default:
917 .BR conv=binary .)
918 Since Linux 1.3.54 this option has no effect anymore.
919 (And non-binary settings used to be very dangerous,
920 possibly leading to silent data corruption.)
921 .TP
922 .B cruft
923 If the high byte of the file length contains other garbage,
924 set this mount option to ignore the high order bits of the file length.
925 This implies that a file cannot be larger than 16MB.
926 The `cruft' option is set automatically if the entire CDROM
927 has a weird size (negative, or more than 800MB). It is also
928 set when volume sequence numbers other than 0 or 1 are seen.
929 .TP
930 .B session=x
931 Select number of session on multisession CD. (Since 2.3.4.)
932 .TP
933 .B sbsector=xxx
934 Session begins from sector xxx. (Since 2.3.4.)
935
936 .SH "Mount options for minix"
937 None.
938
939 .SH "Mount options for msdos"
940 See mount options for fat.
941 If the
942 .I msdos
943 file system detects an inconsistency, it reports an error and sets the file
944 system read-only. The file system can be made writeable again by remounting
945 it.
946
947 .SH "Mount options for ncp"
948 Just like
949 .IR nfs ", the " ncp
950 implementation expects a binary argument (a
951 .IR "struct ncp_mount_data" )
952 to the mount system call. This argument is constructed by
953 .BR ncpmount (8)
954 and the current version of
955 .B mount
956 (2.6h) does not know anything about ncp.
957
958 .SH "Mount options for nfs"
959 Instead of a textual option string, parsed by the kernel, the
960 .I nfs
961 file system expects a binary argument of type
962 .IR "struct nfs_mount_data" .
963 The program
964 .B mount
965 itself parses the following options of the form `tag=value',
966 and puts them in the structure mentioned:
967 .BI rsize= n,
968 .BI wsize= n,
969 .BI timeo= n,
970 .BI retrans= n,
971 .BI acregmin= n,
972 .BI acregmax= n,
973 .BI acdirmin= n,
974 .BI acdirmax= n,
975 .BI actimeo= n,
976 .BI retry= n,
977 .BI port= n,
978 .BI mountport= n,
979 .BI mounthost= name,
980 .BI mountprog= n,
981 .BI mountvers= n,
982 .BI nfsprog= n,
983 .BI nfsvers= n,
984 .BI namlen= n.
985 The option
986 .BI addr= n
987 is accepted but ignored.
988 Also the following Boolean options, possibly preceded by
989 .B no
990 are recognized:
991 .BR bg ,
992 .BR fg ,
993 .BR soft ,
994 .BR hard ,
995 .BR intr ,
996 .BR posix ,
997 .BR cto ,
998 .BR ac ,
999 .BR tcp ,
1000 .BR udp ,
1001 .BR lock .
1002 For details, see
1003 .BR nfs (5).
1004
1005 Especially useful options include
1006 .TP
1007 .B rsize=8192,wsize=8192
1008 This will make your nfs connection much faster than with the default
1009 buffer size of 1024. (NFSv2 does not work with larger values of
1010 .B rsize
1011 and
1012 .BR wsize .)
1013 .TP
1014 .B hard
1015 The program accessing a file on a NFS mounted file system will hang
1016 when the server crashes. The process cannot be interrupted or
1017 killed unless you also specify
1018 .BR intr .
1019 When the NFS server is back online the program will continue undisturbed
1020 from where it was. This is probably what you want.
1021 .TP
1022 .B soft
1023 This option allows the kernel to time out if the nfs server is not
1024 responding for some time. The time can be
1025 specified with
1026 .BR timeo=time .
1027 This option might be useful if your nfs server sometimes doesn't respond
1028 or will be rebooted while some process tries to get a file from the server.
1029 Usually it just causes lots of trouble.
1030 .TP
1031 .B nolock
1032 Do not use locking. Do not start lockd.
1033
1034 .SH "Mount options for ntfs"
1035 .TP
1036 .BI iocharset= name
1037 Character set to use when returning file names.
1038 Unlike VFAT, NTFS suppresses names that contain
1039 unconvertible characters.
1040 .TP
1041 .BR utf8
1042 Use UTF-8 for converting file names.
1043 .TP
1044 .B uni_xlate=[0|1|2]
1045 For 0 (or `no' or `false') or 1 (or `yes' or `true'):
1046 use the VFAT-style encoding for file names outside the current
1047 character set. A value of 2 will disable the encoding with ":".
1048 .TP
1049 .B posix=[0|1]
1050 If enabled (posix=1), the file system distinguishes between
1051 upper and lower case. The 8.3 alias names are presented as
1052 hard links instead of being suppressed.
1053 .TP
1054 \fBuid=\fP\fIvalue\fP, \fBgid=\fP\fIvalue\fP and \fBumask=\fP\fIvalue\fP
1055 Set the file permission on the filesystem.
1056 By default, the files are owned by root and not readable by somebody else.
1057
1058 .SH "Mount options for proc"
1059 .TP
1060 \fBuid=\fP\fIvalue\fP and \fBgid=\fP\fIvalue\fP
1061 These options are recognized, but have no effect as far as I can see.
1062
1063 .SH "Mount options for romfs"
1064 None.
1065
1066 .SH "Mount options for smbfs"
1067 Just like
1068 .IR nfs ", the " smb
1069 implementation expects a binary argument (a
1070 .IR "struct smb_mount_data" )
1071 to the mount system call. This argument is constructed by
1072 .BR smbmount (8)
1073 and the current version of
1074 .B mount
1075 (2.9w) does not know anything about smb.
1076
1077 .SH "Mount options for sysv"
1078 None.
1079
1080 .SH "Mount options for udf"
1081 .TP
1082 .B gid=
1083 Set the default group.
1084 .TP
1085 .B umask=
1086 Set the default umask.
1087 .TP
1088 .B uid=
1089 Set the default user.
1090 .TP
1091 .B unhide
1092 Show otherwise hidden files.
1093 .TP
1094 .B undelete
1095 Show deleted files in lists.
1096 .TP
1097 .B strict
1098 Set strict conformance (unused).
1099 .TP
1100 .B utf8
1101 (unused).
1102 .TP
1103 .B iocharset
1104 (unused).
1105 .TP
1106 .B bs=
1107 Set the block size. (May not work unless 2048.)
1108 .TP
1109 .B novrs
1110 Skip volume sequence recognition.
1111 .TP
1112 .B session=
1113 Set the CDROM session counting from 0. Default: last session.
1114 .TP
1115 .B anchor=
1116 Override standard anchor location. Default: 256.
1117 .TP
1118 .B volume=
1119 Override the VolumeDesc location. (unused)
1120 .TP
1121 .B partition=
1122 Override the PartitionDesc location. (unused)
1123 .TP
1124 .B lastblock=
1125 Set the last block of the filesystem.
1126 .TP
1127 .B fileset=
1128 Override the fileset block location. (unused)
1129 .TP
1130 .B rootdir=
1131 Override the root directory location. (unused)
1132
1133 .SH "Mount options for ufs"
1134 .TP
1135 .BI ufstype= value
1136 UFS is a file system widely used in different operating systems.
1137 The problem are differences among implementations. Features of some
1138 implementations are undocumented, so its hard to recognize the
1139 type of ufs automatically.
1140 That's why user must specify the type of ufs by mount option.
1141 Possible values are:
1142 .RS
1143 .TP
1144 .B old
1145 Old format of ufs, this is the default, read only.
1146 .TP
1147 .B 44bsd
1148 For filesystems created by a BSD-like system (NetBSD,FreeBSD,OpenBSD).
1149 .TP
1150 .B sun
1151 For filesystems created by SunOS or Solaris on Sparc.
1152 .TP
1153 .B sunx86
1154 For filesystems created by Solaris on x86.
1155 .TP
1156 .B nextstep
1157 For filesystems created by NeXTStep (on NeXT station) (currently read only).
1158 .TP
1159 .B nextstep-cd
1160 For NextStep CDROMs (block_size == 2048), read-only.
1161 .TP
1162 .B openstep
1163 For filesystems created by OpenStep (currently read only).
1164 .RE
1165
1166 .TP
1167 .BI onerror= value
1168 Set behaviour on error:
1169 .RS
1170 .TP
1171 .B panic
1172 If an error is encountered, cause a kernel panic.
1173 .TP
1174 .B [lock|umount|repair]
1175 These mount options don't do anything at present;
1176 when an error is encountered only a console message is printed.
1177 .RE
1178
1179 .SH "Mount options for umsdos"
1180 See mount options for msdos.
1181 The
1182 .B dotsOK
1183 option is explicitly killed by
1184 .IR umsdos .
1185
1186 .SH "Mount options for vfat"
1187 First of all, the mount options for
1188 .I fat
1189 are recognized.
1190 The
1191 .B dotsOK
1192 option is explicitly killed by
1193 .IR vfat .
1194 Furthermore, there are
1195 .TP
1196 .B uni_xlate
1197 Translate unhandled Unicode characters to special escaped sequences.
1198 This lets you backup and restore filenames that are created with any
1199 Unicode characters. Without this option, a '?' is used when no
1200 translation is possible. The escape character is ':' because it is
1201 otherwise illegal on the vfat filesystem. The escape sequence
1202 that gets used, where u is the unicode character,
1203 is: ':', (u & 0x3f), ((u>>6) & 0x3f), (u>>12).
1204 .TP
1205 .B posix
1206 Allow two files with names that only differ in case.
1207 .TP
1208 .B nonumtail
1209 First try to make a short name without sequence number,
1210 before trying
1211 .IR name~num.ext .
1212 .TP
1213 .B utf8
1214 UTF8 is the filesystem safe 8-bit encoding of Unicode that is used
1215 by the console. It can be be enabled for the filesystem with this option.
1216 If `uni_xlate' gets set, UTF8 gets disabled.
1217
1218 .SH "Mount options for xenix"
1219 None.
1220
1221 .SH "Mount options for xiafs"
1222 None. Although nothing is wrong with xiafs, it is not used much,
1223 and is not maintained. Probably one shouldn't use it.
1224 Since Linux version 2.1.21 xiafs is no longer part of the kernel source.
1225
1226 .SH "THE LOOP DEVICE"
1227 One further possible type is a mount via the loop device. For example,
1228 the command
1229
1230 .nf
1231 .B " mount /tmp/fdimage /mnt -t msdos -o loop=/dev/loop3,blocksize=1024"
1232 .fi
1233
1234 will set up the loop device
1235 .I /dev/loop3
1236 to correspond to the file
1237 .IR /tmp/fdimage ,
1238 and then mount this device on
1239 .IR /mnt .
1240 This type of mount knows about three options, namely
1241 .BR loop ", " offset " and " encryption ,
1242 that are really options to
1243 .BR losetup (8).
1244 If no explicit loop device is mentioned
1245 (but just an option `\fB\-o loop\fP' is given), then
1246 .B mount
1247 will try to find some unused loop device and use that.
1248 If you are not so unwise as to make
1249 .I /etc/mtab
1250 a symbolic link to
1251 .I /proc/mounts
1252 then any loop device allocated by
1253 .B mount
1254 will be freed by
1255 .BR umount .
1256 You can also free a loop device by hand, using `losetup -d', see
1257 .BR losetup (8).
1258
1259 .SH FILES
1260 .I /etc/fstab
1261 file system table
1262 .br
1263 .I /etc/mtab
1264 table of mounted file systems
1265 .br
1266 .I /etc/mtab~
1267 lock file
1268 .br
1269 .I /etc/mtab.tmp
1270 temporary file
1271 .SH "SEE ALSO"
1272 .BR mount (2),
1273 .BR umount (2),
1274 .BR fstab (5),
1275 .BR umount (8),
1276 .BR swapon (8),
1277 .BR nfs (5),
1278 .BR e2label (8),
1279 .BR mountd (8),
1280 .BR nfsd (8),
1281 .BR mke2fs (8),
1282 .BR tune2fs (8),
1283 .BR losetup (8)
1284 .SH BUGS
1285 It is possible for a corrupted file system to cause a crash.
1286 .PP
1287 Some Linux file systems don't support
1288 .B "\-o sync"
1289 (the ext2fs
1290 .I does
1291 support synchronous updates (a la BSD) when mounted with the
1292 .B sync
1293 option).
1294 .PP
1295 The
1296 .B "\-o remount"
1297 may not be able to change mount parameters (all
1298 .IR ext2fs -specific
1299 parameters, except
1300 .BR sb ,
1301 are changeable with a remount, for example, but you can't change
1302 .B gid
1303 or
1304 .B umask
1305 for the
1306 .IR fatfs ).
1307 .SH HISTORY
1308 A
1309 .B mount
1310 command existed in Version 5 AT&T UNIX.