2004-11-03 13:51:07 +00:00
|
|
|
.\" Copyright (C) 1993 Rickard E. Faith <faith@cs.unc.edu>
|
2006-05-22 23:52:24 +00:00
|
|
|
.\" and Copyright (C) 1994 Andries E. Brouwer <aeb@cwi.nl>
|
2016-06-04 15:38:59 +00:00
|
|
|
.\" and Copyright (C) 2002, 2005, 2016 Michael Kerrisk <mtk.manpages@gmail.com>
|
2004-11-03 13:51:07 +00:00
|
|
|
.\"
|
intro.1, _exit.2, access.2, alarm.2, alloc_hugepages.2, arch_prctl.2, bind.2, chdir.2, chmod.2, chown.2, chroot.2, clock_getres.2, clock_nanosleep.2, close.2, connect.2, delete_module.2, dup.2, execve.2, exit_group.2, faccessat.2, fchmodat.2, fchownat.2, fcntl.2, fork.2, fstatat.2, fsync.2, futimesat.2, get_robust_list.2, getdents.2, getdomainname.2, getgid.2, getgroups.2, gethostname.2, getpagesize.2, getpid.2, getresuid.2, getrlimit.2, getrusage.2, gettid.2, gettimeofday.2, getuid.2, getunwind.2, idle.2, init_module.2, intro.2, iopl.2, kcmp.2, kexec_load.2, kill.2, link.2, linkat.2, llseek.2, lookup_dcookie.2, madvise.2, mincore.2, mkdirat.2, mknodat.2, mmap.2, mmap2.2, mount.2, mprotect.2, mq_getsetattr.2, msgctl.2, msgget.2, msgop.2, msync.2, nice.2, open.2, openat.2, pause.2, perfmonctl.2, personality.2, pipe.2, poll.2, posix_fadvise.2, prctl.2, pread.2, process_vm_readv.2, quotactl.2, read.2, readahead.2, readdir.2, readlinkat.2, readv.2, reboot.2, recvmmsg.2, remap_file_pages.2, rename.2, renameat.2, rmdir.2, rt_sigqueueinfo.2, select.2, select_tut.2, semctl.2, semget.2, semop.2, sendmmsg.2, set_tid_address.2, seteuid.2, setfsgid.2, setfsuid.2, setgid.2, setresuid.2, setuid.2, setup.2, sgetmask.2, shmctl.2, shmget.2, shmop.2, sigaction.2, sigaltstack.2, signal.2, sigpending.2, sigprocmask.2, sigreturn.2, sigsuspend.2, sigwaitinfo.2, splice.2, stat.2, statfs.2, stime.2, subpage_prot.2, swapon.2, symlink.2, symlinkat.2, sync.2, sync_file_range.2, syscalls.2, sysctl.2, sysfs.2, syslog.2, tee.2, time.2, timer_create.2, timer_delete.2, timer_getoverrun.2, timer_settime.2, times.2, tkill.2, umask.2, umount.2, uname.2, unlink.2, unlinkat.2, uselib.2, ustat.2, utime.2, utimensat.2, vfork.2, vhangup.2, vm86.2, vmsplice.2, wait.2, wait4.2, write.2, CPU_SET.3, INFINITY.3, abort.3, abs.3, acos.3, acosh.3, adjtime.3, aio_init.3, asin.3, asinh.3, asprintf.3, assert.3, assert_perror.3, atan.3, atan2.3, atanh.3, atexit.3, atof.3, atoi.3, basename.3, bcmp.3, bcopy.3, bindresvport.3, bsd_signal.3, bsearch.3, bstring.3, byteorder.3, bzero.3, catgets.3, catopen.3, cbrt.3, ceil.3, clearenv.3, clock.3, clock_getcpuclockid.3, closedir.3, confstr.3, copysign.3, cos.3, cosh.3, ctermid.3, ctime.3, difftime.3, dirfd.3, div.3, dl_iterate_phdr.3, dprintf.3, drand48.3, drand48_r.3, dysize.3, ecvt.3, ecvt_r.3, end.3, endian.3, erf.3, erfc.3, ether_aton.3, euidaccess.3, exit.3, exp.3, exp10.3, exp2.3, expm1.3, fabs.3, fcloseall.3, fexecve.3, ffs.3, fgetgrent.3, fgetpwent.3, finite.3, flockfile.3, floor.3, fmod.3, fnmatch.3, fopencookie.3, fpathconf.3, fpurge.3, frexp.3, fseeko.3, ftok.3, futimes.3, gcvt.3, get_nprocs_conf.3, getaddrinfo.3, getaddrinfo_a.3, getauxval.3, getcontext.3, getcwd.3, getdate.3, getdirentries.3, getdtablesize.3, getenv.3, getfsent.3, getgrent.3, getgrnam.3, getgrouplist.3, gethostbyname.3, gethostid.3, getifaddrs.3, getipnodebyname.3, getline.3, getlogin.3, getmntent.3, getnetent.3, getnetent_r.3, getopt.3, getprotoent.3, getprotoent_r.3, getpw.3, getpwent.3, getpwnam.3, getrpcent_r.3, gets.3, getservent.3, getservent_r.3, getumask.3, getusershell.3, getutmp.3, getw.3, glob.3, gnu_get_libc_version.3, gsignal.3, hypot.3, if_nameindex.3, if_nametoindex.3, ilogb.3, index.3, inet.3, inet_ntop.3, inet_pton.3, infnan.3, initgroups.3, insque.3, intro.3, isalpha.3, isatty.3, j0.3, ldexp.3, localeconv.3, log.3, log10.3, log1p.3, log2.3, logb.3, lrint.3, lround.3, lsearch.3, lseek64.3, makecontext.3, makedev.3, mallinfo.3, malloc.3, malloc_get_state.3, malloc_info.3, malloc_stats.3, malloc_trim.3, malloc_usable_size.3, mallopt.3, matherr.3, mcheck.3, memccpy.3, memchr.3, memcmp.3, memcpy.3, memfrob.3, memmem.3, memmove.3, memset.3, mkdtemp.3, mkfifo.3, mkfifoat.3, mkstemp.3, mktemp.3, modf.3, mq_close.3, mq_getattr.3, mq_notify.3, mq_open.3, mq_receive.3, mq_send.3, mq_unlink.3, mtrace.3, on_exit.3, opendir.3, posix_fallocate.3, posix_memalign.3, posix_openpt.3, pow.3, pow10.3, profil.3, psignal.3, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setscope.3, pthread_attr_setstack.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_cleanup_push_defer_np.3, pthread_create.3, pthread_detach.3, pthread_equal.3, pthread_exit.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_join.3, pthread_kill.3, pthread_kill_other_threads_np.3, pthread_self.3, pthread_setaffinity_np.3, pthread_setcancelstate.3, pthread_setconcurrency.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_setschedprio.3, pthread_sigmask.3, pthread_sigqueue.3, pthread_testcancel.3, pthread_tryjoin_np.3, pthread_yield.3, putenv.3, putpwent.3, puts.3, qecvt.3, qsort.3, raise.3, rand.3, random.3, random_r.3, re_comp.3, readdir.3, realpath.3, regex.3, remainder.3, remove.3, resolver.3, rewinddir.3, rint.3, round.3, scalb.3, scalbln.3, scandir.3, sched_getcpu.3, seekdir.3, sem_close.3, sem_destroy.3, sem_getvalue.3, sem_init.3, sem_open.3, sem_post.3, sem_unlink.3, sem_wait.3, setenv.3, setlocale.3, setlogmask.3, shm_open.3, siginterrupt.3, sigpause.3, sigqueue.3, sigset.3, sigsetops.3, sigvec.3, sigwait.3, sin.3, sinh.3, sleep.3, sockatmark.3, sqrt.3, statvfs.3, stdio_ext.3, stpcpy.3, strcasecmp.3, strcat.3, strchr.3, strcmp.3, strcoll.3, strcpy.3, strdup.3, strerror.3, strfry.3, strftime.3, string.3, strlen.3, strpbrk.3, strptime.3, strsep.3, strsignal.3, strspn.3, strstr.3, strtok.3, strtol.3, strtoul.3, strverscmp.3, strxfrm.3, swab.3, sysconf.3, syslog.3, system.3, sysv_signal.3, tan.3, tanh.3, tcgetpgrp.3, tcgetsid.3, telldir.3, tempnam.3, timegm.3, timeradd.3, tmpfile.3, tmpnam.3, toascii.3, toupper.3, trunc.3, tsearch.3, ttyslot.3, tzset.3, ulimit.3, undocumented.3, unlocked_stdio.3, usleep.3, y0.3, cpuid.4, full.4, initrd.4, mouse.4, msr.4, sd.4, st.4, acct.5, core.5, services.5, slabinfo.5, aio.7, capabilities.7, credentials.7, feature_test_macros.7, hier.7, inotify.7, libc.7, locale.7, man-pages.7, man.7, math_error.7, mq_overview.7, numa.7, path_resolution.7, pipe.7, pthreads.7, pty.7, rtld-audit.7, sem_overview.7, shm_overview.7, sigevent.7, signal.7, suffixes.7, svipc.7, termio.7, time.7, udplite.7, units.7, uri.7, sln.8: s/LICENSE_START(verbatim)/LICENSE_START(VERBATIM)/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-03-10 09:29:01 +00:00
|
|
|
.\" %%%LICENSE_START(VERBATIM)
|
2004-11-03 13:51:07 +00:00
|
|
|
.\" Permission is granted to make and distribute verbatim copies of this
|
|
|
|
.\" manual provided the copyright notice and this permission notice are
|
|
|
|
.\" preserved on all copies.
|
|
|
|
.\"
|
|
|
|
.\" Permission is granted to copy and distribute modified versions of this
|
|
|
|
.\" manual under the conditions for verbatim copying, provided that the
|
|
|
|
.\" entire resulting derived work is distributed under the terms of a
|
|
|
|
.\" permission notice identical to this one.
|
2007-04-12 22:42:49 +00:00
|
|
|
.\"
|
2004-11-03 13:51:07 +00:00
|
|
|
.\" Since the Linux kernel and libraries are constantly changing, this
|
|
|
|
.\" manual page may be incorrect or out-of-date. The author(s) assume no
|
|
|
|
.\" responsibility for errors or omissions, or for damages resulting from
|
|
|
|
.\" the use of the information contained herein. The author(s) may not
|
|
|
|
.\" have taken the same level of care in the production of this manual,
|
|
|
|
.\" which is licensed free of charge, as they might when working
|
|
|
|
.\" professionally.
|
2007-04-12 22:42:49 +00:00
|
|
|
.\"
|
2004-11-03 13:51:07 +00:00
|
|
|
.\" Formatted or processed versions of this manual, if unaccompanied by
|
|
|
|
.\" the source, must acknowledge the copyright and authors of this work.
|
intro.1, _exit.2, access.2, alarm.2, alloc_hugepages.2, arch_prctl.2, bind.2, chdir.2, chmod.2, chown.2, chroot.2, clock_getres.2, clock_nanosleep.2, close.2, connect.2, delete_module.2, dup.2, execve.2, exit_group.2, faccessat.2, fchmodat.2, fchownat.2, fcntl.2, fork.2, fstatat.2, fsync.2, futimesat.2, get_robust_list.2, getdents.2, getdomainname.2, getgid.2, getgroups.2, gethostname.2, getpagesize.2, getpid.2, getresuid.2, getrlimit.2, getrusage.2, gettid.2, gettimeofday.2, getuid.2, getunwind.2, idle.2, init_module.2, intro.2, iopl.2, kcmp.2, kexec_load.2, kill.2, link.2, linkat.2, llseek.2, lookup_dcookie.2, madvise.2, mincore.2, mkdirat.2, mknodat.2, mmap.2, mmap2.2, mount.2, mprotect.2, mq_getsetattr.2, msgctl.2, msgget.2, msgop.2, msync.2, nice.2, open.2, openat.2, pause.2, perfmonctl.2, personality.2, pipe.2, poll.2, posix_fadvise.2, prctl.2, pread.2, process_vm_readv.2, quotactl.2, read.2, readahead.2, readdir.2, readlinkat.2, readv.2, reboot.2, recvmmsg.2, remap_file_pages.2, rename.2, renameat.2, rmdir.2, rt_sigqueueinfo.2, select.2, select_tut.2, semctl.2, semget.2, semop.2, sendmmsg.2, set_tid_address.2, seteuid.2, setfsgid.2, setfsuid.2, setgid.2, setresuid.2, setuid.2, setup.2, sgetmask.2, shmctl.2, shmget.2, shmop.2, sigaction.2, sigaltstack.2, signal.2, sigpending.2, sigprocmask.2, sigreturn.2, sigsuspend.2, sigwaitinfo.2, splice.2, stat.2, statfs.2, stime.2, subpage_prot.2, swapon.2, symlink.2, symlinkat.2, sync.2, sync_file_range.2, syscalls.2, sysctl.2, sysfs.2, syslog.2, tee.2, time.2, timer_create.2, timer_delete.2, timer_getoverrun.2, timer_settime.2, times.2, tkill.2, umask.2, umount.2, uname.2, unlink.2, unlinkat.2, uselib.2, ustat.2, utime.2, utimensat.2, vfork.2, vhangup.2, vm86.2, vmsplice.2, wait.2, wait4.2, write.2, CPU_SET.3, INFINITY.3, abort.3, abs.3, acos.3, acosh.3, adjtime.3, aio_init.3, asin.3, asinh.3, asprintf.3, assert.3, assert_perror.3, atan.3, atan2.3, atanh.3, atexit.3, atof.3, atoi.3, basename.3, bcmp.3, bcopy.3, bindresvport.3, bsd_signal.3, bsearch.3, bstring.3, byteorder.3, bzero.3, catgets.3, catopen.3, cbrt.3, ceil.3, clearenv.3, clock.3, clock_getcpuclockid.3, closedir.3, confstr.3, copysign.3, cos.3, cosh.3, ctermid.3, ctime.3, difftime.3, dirfd.3, div.3, dl_iterate_phdr.3, dprintf.3, drand48.3, drand48_r.3, dysize.3, ecvt.3, ecvt_r.3, end.3, endian.3, erf.3, erfc.3, ether_aton.3, euidaccess.3, exit.3, exp.3, exp10.3, exp2.3, expm1.3, fabs.3, fcloseall.3, fexecve.3, ffs.3, fgetgrent.3, fgetpwent.3, finite.3, flockfile.3, floor.3, fmod.3, fnmatch.3, fopencookie.3, fpathconf.3, fpurge.3, frexp.3, fseeko.3, ftok.3, futimes.3, gcvt.3, get_nprocs_conf.3, getaddrinfo.3, getaddrinfo_a.3, getauxval.3, getcontext.3, getcwd.3, getdate.3, getdirentries.3, getdtablesize.3, getenv.3, getfsent.3, getgrent.3, getgrnam.3, getgrouplist.3, gethostbyname.3, gethostid.3, getifaddrs.3, getipnodebyname.3, getline.3, getlogin.3, getmntent.3, getnetent.3, getnetent_r.3, getopt.3, getprotoent.3, getprotoent_r.3, getpw.3, getpwent.3, getpwnam.3, getrpcent_r.3, gets.3, getservent.3, getservent_r.3, getumask.3, getusershell.3, getutmp.3, getw.3, glob.3, gnu_get_libc_version.3, gsignal.3, hypot.3, if_nameindex.3, if_nametoindex.3, ilogb.3, index.3, inet.3, inet_ntop.3, inet_pton.3, infnan.3, initgroups.3, insque.3, intro.3, isalpha.3, isatty.3, j0.3, ldexp.3, localeconv.3, log.3, log10.3, log1p.3, log2.3, logb.3, lrint.3, lround.3, lsearch.3, lseek64.3, makecontext.3, makedev.3, mallinfo.3, malloc.3, malloc_get_state.3, malloc_info.3, malloc_stats.3, malloc_trim.3, malloc_usable_size.3, mallopt.3, matherr.3, mcheck.3, memccpy.3, memchr.3, memcmp.3, memcpy.3, memfrob.3, memmem.3, memmove.3, memset.3, mkdtemp.3, mkfifo.3, mkfifoat.3, mkstemp.3, mktemp.3, modf.3, mq_close.3, mq_getattr.3, mq_notify.3, mq_open.3, mq_receive.3, mq_send.3, mq_unlink.3, mtrace.3, on_exit.3, opendir.3, posix_fallocate.3, posix_memalign.3, posix_openpt.3, pow.3, pow10.3, profil.3, psignal.3, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setscope.3, pthread_attr_setstack.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_cleanup_push_defer_np.3, pthread_create.3, pthread_detach.3, pthread_equal.3, pthread_exit.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_join.3, pthread_kill.3, pthread_kill_other_threads_np.3, pthread_self.3, pthread_setaffinity_np.3, pthread_setcancelstate.3, pthread_setconcurrency.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_setschedprio.3, pthread_sigmask.3, pthread_sigqueue.3, pthread_testcancel.3, pthread_tryjoin_np.3, pthread_yield.3, putenv.3, putpwent.3, puts.3, qecvt.3, qsort.3, raise.3, rand.3, random.3, random_r.3, re_comp.3, readdir.3, realpath.3, regex.3, remainder.3, remove.3, resolver.3, rewinddir.3, rint.3, round.3, scalb.3, scalbln.3, scandir.3, sched_getcpu.3, seekdir.3, sem_close.3, sem_destroy.3, sem_getvalue.3, sem_init.3, sem_open.3, sem_post.3, sem_unlink.3, sem_wait.3, setenv.3, setlocale.3, setlogmask.3, shm_open.3, siginterrupt.3, sigpause.3, sigqueue.3, sigset.3, sigsetops.3, sigvec.3, sigwait.3, sin.3, sinh.3, sleep.3, sockatmark.3, sqrt.3, statvfs.3, stdio_ext.3, stpcpy.3, strcasecmp.3, strcat.3, strchr.3, strcmp.3, strcoll.3, strcpy.3, strdup.3, strerror.3, strfry.3, strftime.3, string.3, strlen.3, strpbrk.3, strptime.3, strsep.3, strsignal.3, strspn.3, strstr.3, strtok.3, strtol.3, strtoul.3, strverscmp.3, strxfrm.3, swab.3, sysconf.3, syslog.3, system.3, sysv_signal.3, tan.3, tanh.3, tcgetpgrp.3, tcgetsid.3, telldir.3, tempnam.3, timegm.3, timeradd.3, tmpfile.3, tmpnam.3, toascii.3, toupper.3, trunc.3, tsearch.3, ttyslot.3, tzset.3, ulimit.3, undocumented.3, unlocked_stdio.3, usleep.3, y0.3, cpuid.4, full.4, initrd.4, mouse.4, msr.4, sd.4, st.4, acct.5, core.5, services.5, slabinfo.5, aio.7, capabilities.7, credentials.7, feature_test_macros.7, hier.7, inotify.7, libc.7, locale.7, man-pages.7, man.7, math_error.7, mq_overview.7, numa.7, path_resolution.7, pipe.7, pthreads.7, pty.7, rtld-audit.7, sem_overview.7, shm_overview.7, sigevent.7, signal.7, suffixes.7, svipc.7, termio.7, time.7, udplite.7, units.7, uri.7, sln.8: Global fix: Add LICENSE_START(verbatim)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-03-10 09:28:40 +00:00
|
|
|
.\" %%%LICENSE_END
|
2004-11-03 13:51:07 +00:00
|
|
|
.\"
|
|
|
|
.\" Modified 1996-11-04 by Eric S. Raymond <esr@thyrsus.com>
|
2007-09-20 06:52:22 +00:00
|
|
|
.\" Modified 2001-10-13 by Michael Kerrisk <mtk.manpages@gmail.com>
|
2007-06-08 09:56:56 +00:00
|
|
|
.\" Added note on historical behavior of MS_NOSUID
|
2007-09-20 06:52:22 +00:00
|
|
|
.\" Modified 2002-05-16 by Michael Kerrisk <mtk.manpages@gmail.com>
|
2004-11-03 13:51:07 +00:00
|
|
|
.\" Extensive changes and additions
|
|
|
|
.\" Modified 2002-05-27 by aeb
|
2007-09-20 06:52:22 +00:00
|
|
|
.\" Modified 2002-06-11 by Michael Kerrisk <mtk.manpages@gmail.com>
|
2004-11-03 13:51:07 +00:00
|
|
|
.\" Enhanced descriptions of MS_MOVE, MS_BIND, and MS_REMOUNT
|
2007-09-20 06:52:22 +00:00
|
|
|
.\" Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com>
|
2005-05-18 14:34:43 +00:00
|
|
|
.\" 2005-05-18, mtk, Added MNT_EXPIRE, plus a few other tidy-ups.
|
2008-10-06 12:07:03 +00:00
|
|
|
.\" 2008-10-06, mtk: move umount*() material into separate umount.2 page.
|
|
|
|
.\" 2008-10-06, mtk: Add discussion of namespaces.
|
2004-11-03 13:51:07 +00:00
|
|
|
.\"
|
ldd.1, localedef.1, add_key.2, chroot.2, clone.2, fork.2, futex.2, get_mempolicy.2, get_robust_list.2, getitimer.2, getpriority.2, ioctl.2, ioctl_ficlonerange.2, ioctl_fideduperange.2, kcmp.2, kill.2, lookup_dcookie.2, mmap.2, mount.2, open.2, pciconfig_read.2, perf_event_open.2, prctl.2, process_vm_readv.2, ptrace.2, quotactl.2, recv.2, setfsgid.2, setfsuid.2, sysinfo.2, umask.2, umount.2, unshare.2, utimensat.2, wait.2, assert.3, fmax.3, fmin.3, getauxval.3, inet_pton.3, malloc_hook.3, memmem.3, mkdtemp.3, mktemp.3, printf.3, strcasecmp.3, strcat.3, strtoul.3, strxfrm.3, console_codes.4, console_ioctl.4, lirc.4, tty.4, vcs.4, charmap.5, elf.5, locale.5, proc.5, repertoiremap.5, utmp.5, capabilities.7, cgroup_namespaces.7, cgroups.7, charsets.7, cp1251.7, cp1252.7, credentials.7, feature_test_macros.7, iso_8859-1.7, iso_8859-15.7, iso_8859-5.7, koi8-r.7, koi8-u.7, man-pages.7, mount_namespaces.7, namespaces.7, netlink.7, pid_namespaces.7, unix.7, user_namespaces.7, utf-8.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-07-17 16:07:58 +00:00
|
|
|
.TH MOUNT 2 2016-07-17 "Linux" "Linux Programmer's Manual"
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH NAME
|
intro.1, time.1, access.2, acct.2, alloc_hugepages.2, bind.2, chdir.2, chmod.2, chown.2, chroot.2, clone.2, close.2, execve.2, fallocate.2, fcntl.2, getdents.2, getrusage.2, getxattr.2, init_module.2, inotify_add_watch.2, ioprio_set.2, kcmp.2, link.2, listxattr.2, lseek.2, madvise.2, mkdir.2, mknod.2, mmap.2, mount.2, move_pages.2, msgctl.2, nfsservctl.2, open.2, pivot_root.2, quotactl.2, read.2, readlink.2, removexattr.2, rename.2, rmdir.2, semctl.2, setfsgid.2, setfsuid.2, setresuid.2, setuid.2, setup.2, setxattr.2, shmctl.2, splice.2, spu_create.2, stat.2, statfs.2, swapon.2, symlink.2, sync.2, sync_file_range.2, sysfs.2, truncate.2, umount.2, unlink.2, unshare.2, ustat.2, utime.2, utimensat.2, write.2, btree.3, errno.3, fexecve.3, ftw.3, futimes.3, get_nprocs_conf.3, getcwd.3, getdirentries.3, getmntent.3, glob.3, mkfifo.3, mq_open.3, readdir.3, realpath.3, recno.3, remove.3, sem_open.3, shm_open.3, statvfs.3, sysconf.3, telldir.3, tmpfile.3, cciss.4, initrd.4, pts.4, sk98lin.4, vcs.4, core.5, filesystems.5, proc.5, boot.7, bootparam.7, capabilities.7, cpuset.7, credentials.7, feature_test_macros.7, fifo.7, hier.7, inotify.7, intro.7, mq_overview.7, path_resolution.7, pipe.7, sem_overview.7, shm_overview.7, spufs.7, symlink.7, unix.7, uri.7, sync.8: Global fix: s/file system/filesystem/
Notwithstanding 24d01c530c5a3f75217543d02bf6712395e5f90c,
"filesystem" is the form used by the great majority of man pages
outside the man-pages project and in a number of other sources,
so let's go with that.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 08:07:57 +00:00
|
|
|
mount \- mount filesystem
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH SYNOPSIS
|
2006-04-25 06:09:55 +00:00
|
|
|
.nf
|
2004-11-03 13:51:07 +00:00
|
|
|
.B "#include <sys/mount.h>"
|
|
|
|
.sp
|
|
|
|
.BI "int mount(const char *" source ", const char *" target ,
|
2006-04-25 06:09:55 +00:00
|
|
|
.BI " const char *" filesystemtype ", unsigned long " mountflags ,
|
|
|
|
.BI " const void *" data );
|
|
|
|
.fi
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH DESCRIPTION
|
2005-10-19 06:54:38 +00:00
|
|
|
.BR mount ()
|
intro.1, time.1, access.2, acct.2, alloc_hugepages.2, bind.2, chdir.2, chmod.2, chown.2, chroot.2, clone.2, close.2, execve.2, fallocate.2, fcntl.2, getdents.2, getrusage.2, getxattr.2, init_module.2, inotify_add_watch.2, ioprio_set.2, kcmp.2, link.2, listxattr.2, lseek.2, madvise.2, mkdir.2, mknod.2, mmap.2, mount.2, move_pages.2, msgctl.2, nfsservctl.2, open.2, pivot_root.2, quotactl.2, read.2, readlink.2, removexattr.2, rename.2, rmdir.2, semctl.2, setfsgid.2, setfsuid.2, setresuid.2, setuid.2, setup.2, setxattr.2, shmctl.2, splice.2, spu_create.2, stat.2, statfs.2, swapon.2, symlink.2, sync.2, sync_file_range.2, sysfs.2, truncate.2, umount.2, unlink.2, unshare.2, ustat.2, utime.2, utimensat.2, write.2, btree.3, errno.3, fexecve.3, ftw.3, futimes.3, get_nprocs_conf.3, getcwd.3, getdirentries.3, getmntent.3, glob.3, mkfifo.3, mq_open.3, readdir.3, realpath.3, recno.3, remove.3, sem_open.3, shm_open.3, statvfs.3, sysconf.3, telldir.3, tmpfile.3, cciss.4, initrd.4, pts.4, sk98lin.4, vcs.4, core.5, filesystems.5, proc.5, boot.7, bootparam.7, capabilities.7, cpuset.7, credentials.7, feature_test_macros.7, fifo.7, hier.7, inotify.7, intro.7, mq_overview.7, path_resolution.7, pipe.7, sem_overview.7, shm_overview.7, spufs.7, symlink.7, unix.7, uri.7, sync.8: Global fix: s/file system/filesystem/
Notwithstanding 24d01c530c5a3f75217543d02bf6712395e5f90c,
"filesystem" is the form used by the great majority of man pages
outside the man-pages project and in a number of other sources,
so let's go with that.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 08:07:57 +00:00
|
|
|
attaches the filesystem specified by
|
2004-11-03 13:51:07 +00:00
|
|
|
.I source
|
2016-05-19 11:13:54 +00:00
|
|
|
(which is often a pathname referring to a device,
|
|
|
|
but can also be the pathname of a directory or file,
|
|
|
|
or a dummy string) to the location (a directory or file)
|
|
|
|
specified by the pathname in
|
2004-11-03 13:51:07 +00:00
|
|
|
.IR target .
|
|
|
|
|
|
|
|
Appropriate privilege (Linux: the
|
|
|
|
.B CAP_SYS_ADMIN
|
intro.1, time.1, access.2, acct.2, alloc_hugepages.2, bind.2, chdir.2, chmod.2, chown.2, chroot.2, clone.2, close.2, execve.2, fallocate.2, fcntl.2, getdents.2, getrusage.2, getxattr.2, init_module.2, inotify_add_watch.2, ioprio_set.2, kcmp.2, link.2, listxattr.2, lseek.2, madvise.2, mkdir.2, mknod.2, mmap.2, mount.2, move_pages.2, msgctl.2, nfsservctl.2, open.2, pivot_root.2, quotactl.2, read.2, readlink.2, removexattr.2, rename.2, rmdir.2, semctl.2, setfsgid.2, setfsuid.2, setresuid.2, setuid.2, setup.2, setxattr.2, shmctl.2, splice.2, spu_create.2, stat.2, statfs.2, swapon.2, symlink.2, sync.2, sync_file_range.2, sysfs.2, truncate.2, umount.2, unlink.2, unshare.2, ustat.2, utime.2, utimensat.2, write.2, btree.3, errno.3, fexecve.3, ftw.3, futimes.3, get_nprocs_conf.3, getcwd.3, getdirentries.3, getmntent.3, glob.3, mkfifo.3, mq_open.3, readdir.3, realpath.3, recno.3, remove.3, sem_open.3, shm_open.3, statvfs.3, sysconf.3, telldir.3, tmpfile.3, cciss.4, initrd.4, pts.4, sk98lin.4, vcs.4, core.5, filesystems.5, proc.5, boot.7, bootparam.7, capabilities.7, cpuset.7, credentials.7, feature_test_macros.7, fifo.7, hier.7, inotify.7, intro.7, mq_overview.7, path_resolution.7, pipe.7, sem_overview.7, shm_overview.7, spufs.7, symlink.7, unix.7, uri.7, sync.8: Global fix: s/file system/filesystem/
Notwithstanding 24d01c530c5a3f75217543d02bf6712395e5f90c,
"filesystem" is the form used by the great majority of man pages
outside the man-pages project and in a number of other sources,
so let's go with that.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 08:07:57 +00:00
|
|
|
capability) is required to mount filesystems.
|
2004-11-03 13:51:07 +00:00
|
|
|
|
|
|
|
Values for the
|
2007-09-20 16:26:31 +00:00
|
|
|
.I filesystemtype
|
2004-11-03 13:51:07 +00:00
|
|
|
argument supported by the kernel are listed in
|
|
|
|
.I /proc/filesystems
|
2016-06-04 12:13:11 +00:00
|
|
|
(e.g., "btrfs", "ext4", "jfs", "xfs", "vfat", "fuse",
|
|
|
|
"tmpfs", "cgroup", "proc", "mqueue", "nfs", "cifs", "iso9660").
|
2004-11-03 13:51:07 +00:00
|
|
|
Further types may become available when the appropriate modules
|
|
|
|
are loaded.
|
|
|
|
|
2016-06-04 12:25:56 +00:00
|
|
|
The
|
|
|
|
.I data
|
|
|
|
argument is interpreted by the different filesystems.
|
|
|
|
Typically it is a string of comma-separated options
|
|
|
|
understood by this filesystem.
|
|
|
|
See
|
|
|
|
.BR mount (8)
|
|
|
|
for details of the options available for each filesystem type.
|
|
|
|
|
2016-06-04 13:44:46 +00:00
|
|
|
A call to
|
|
|
|
.BR mount ()
|
2016-07-28 06:32:32 +00:00
|
|
|
performs one of a number of general types of operation,
|
2016-06-04 13:44:46 +00:00
|
|
|
depending on the bits specified in
|
|
|
|
.IR mountflags .
|
2016-07-28 06:32:32 +00:00
|
|
|
The choice of which operation to perform is determined by
|
|
|
|
testing the bits set in
|
2016-06-04 13:44:46 +00:00
|
|
|
.IR mountflags ,
|
|
|
|
with the tests being conducted in the order listed here:
|
|
|
|
.IP * 3
|
|
|
|
Remount an existing mount:
|
|
|
|
.IR mountflags
|
|
|
|
includes
|
|
|
|
.BR MS_REMOUNT .
|
|
|
|
.IP *
|
|
|
|
Create a bind mount:
|
|
|
|
.IR mountflags
|
|
|
|
includes
|
|
|
|
.BR MS_BIND .
|
|
|
|
.IP *
|
|
|
|
Change the propagation type of an existing mount:
|
|
|
|
.IR mountflags
|
|
|
|
includes one of
|
|
|
|
.BR MS_SHARED ,
|
|
|
|
.BR MS_PRIVATE ,
|
|
|
|
.BR MS_SLAVE ,
|
|
|
|
or
|
|
|
|
.BR MS_UNBINDABLE .
|
|
|
|
.IP *
|
|
|
|
Move an existing mount to a new location:
|
|
|
|
.IR mountflags
|
|
|
|
includes
|
|
|
|
.BR MS_MOVE .
|
|
|
|
.IP *
|
|
|
|
Create a new mount:
|
|
|
|
.IR mountflags
|
|
|
|
includes none of the above flags.
|
|
|
|
.PP
|
|
|
|
Each of these operations is detailed later in this page.
|
|
|
|
Further flags may be specified in
|
|
|
|
.IR mountflags
|
|
|
|
to modify the behavior of
|
|
|
|
.BR mount (),
|
|
|
|
as described below.
|
2013-03-05 09:36:45 +00:00
|
|
|
.\"
|
2016-06-04 13:44:46 +00:00
|
|
|
.SS Additional mount flags
|
|
|
|
The list below describes the additional flags that can be specified in
|
|
|
|
.IR mountflags .
|
|
|
|
Note that some operation types ignore some or all of these flags,
|
|
|
|
as described later in this page.
|
2013-03-05 09:36:45 +00:00
|
|
|
.\"
|
adjtimex.2, bind.2, cacheflush.2, clone.2, fallocate.2, fanotify_init.2, fanotify_mark.2, flock.2, futex.2, getdents.2, getpriority.2, getrlimit.2, gettid.2, gettimeofday.2, ioprio_set.2, kexec_load.2, migrate_pages.2, modify_ldt.2, mount.2, move_pages.2, mprotect.2, msgop.2, nfsservctl.2, perf_event_open.2, pread.2, ptrace.2, recvmmsg.2, rename.2, restart_syscall.2, sched_setattr.2, send.2, shmop.2, shutdown.2, sigaction.2, signalfd.2, syscalls.2, timer_create.2, timerfd_create.2, tkill.2, vmsplice.2, wait.2, aio_init.3, confstr.3, exit.3, fmemopen.3, fopen.3, getaddrinfo.3, getauxval.3, getspnam.3, isalpha.3, isatty.3, mallinfo.3, malloc.3, mallopt.3, psignal.3, pthread_attr_setinheritsched.3, qecvt.3, queue.3, rtnetlink.3, strerror.3, strftime.3, toupper.3, towlower.3, towupper.3, initrd.4, locale.5, proc.5, bootparam.7, capabilities.7, ddp.7, fanotify.7, icmp.7, inotify.7, ip.7, ipv6.7, netdevice.7, netlink.7, path_resolution.7, rtld-audit.7, rtnetlink.7, sched.7, signal.7, socket.7, svipc.7, tcp.7, unix.7, ld.so.8: srcfix: Update FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-21 21:47:44 +00:00
|
|
|
.\" FIXME 2.6.25 Added MS_I_VERSION, which needs to be documented.
|
2009-06-26 12:48:14 +00:00
|
|
|
.\"
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
2005-05-18 14:34:43 +00:00
|
|
|
.BR MS_DIRSYNC " (since Linux 2.5.19)"
|
intro.1, time.1, access.2, acct.2, alloc_hugepages.2, bind.2, chdir.2, chmod.2, chown.2, chroot.2, clone.2, close.2, execve.2, fallocate.2, fcntl.2, getdents.2, getrusage.2, getxattr.2, init_module.2, inotify_add_watch.2, ioprio_set.2, kcmp.2, link.2, listxattr.2, lseek.2, madvise.2, mkdir.2, mknod.2, mmap.2, mount.2, move_pages.2, msgctl.2, nfsservctl.2, open.2, pivot_root.2, quotactl.2, read.2, readlink.2, removexattr.2, rename.2, rmdir.2, semctl.2, setfsgid.2, setfsuid.2, setresuid.2, setuid.2, setup.2, setxattr.2, shmctl.2, splice.2, spu_create.2, stat.2, statfs.2, swapon.2, symlink.2, sync.2, sync_file_range.2, sysfs.2, truncate.2, umount.2, unlink.2, unshare.2, ustat.2, utime.2, utimensat.2, write.2, btree.3, errno.3, fexecve.3, ftw.3, futimes.3, get_nprocs_conf.3, getcwd.3, getdirentries.3, getmntent.3, glob.3, mkfifo.3, mq_open.3, readdir.3, realpath.3, recno.3, remove.3, sem_open.3, shm_open.3, statvfs.3, sysconf.3, telldir.3, tmpfile.3, cciss.4, initrd.4, pts.4, sk98lin.4, vcs.4, core.5, filesystems.5, proc.5, boot.7, bootparam.7, capabilities.7, cpuset.7, credentials.7, feature_test_macros.7, fifo.7, hier.7, inotify.7, intro.7, mq_overview.7, path_resolution.7, pipe.7, sem_overview.7, shm_overview.7, spufs.7, symlink.7, unix.7, uri.7, sync.8: Global fix: s/file system/filesystem/
Notwithstanding 24d01c530c5a3f75217543d02bf6712395e5f90c,
"filesystem" is the form used by the great majority of man pages
outside the man-pages project and in a number of other sources,
so let's go with that.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 08:07:57 +00:00
|
|
|
Make directory changes on this filesystem synchronous.
|
2004-11-03 13:51:07 +00:00
|
|
|
(This property can be obtained for individual directories
|
|
|
|
or subtrees using
|
2007-10-14 18:33:54 +00:00
|
|
|
.BR chattr (1).)
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
2015-03-03 07:13:19 +00:00
|
|
|
.BR MS_LAZYTIME " (since Linux 4.0)"
|
2015-02-20 08:50:01 +00:00
|
|
|
.\" commit 0ae45f63d4ef8d8eeec49c7d8b44a1775fff13e8
|
|
|
|
.\" commit fe032c422c5ba562ba9c2d316f55e258e03259c6
|
|
|
|
.\" commit a26f49926da938f47561f386be56a83dd37a496d
|
|
|
|
Reduce on-disk updates of inode timestamps (atime, mtime, ctime)
|
|
|
|
by maintaining these changes only in memory.
|
|
|
|
The on-disk timestamps are updated only when:
|
|
|
|
.RS
|
|
|
|
.IP (a) 5
|
|
|
|
the inode needs to be updated for some change unrelated to file timestamps;
|
|
|
|
.IP (b)
|
|
|
|
the application employs
|
|
|
|
.BR fsync (2),
|
|
|
|
.BR syncfs (2),
|
|
|
|
or
|
|
|
|
.BR sync (2);
|
|
|
|
.IP (c)
|
|
|
|
an undeleted inode is evicted from memory; or
|
|
|
|
.IP (d)
|
|
|
|
more than 24 hours have passed since the inode was written to disk.
|
|
|
|
.RE
|
|
|
|
.IP
|
2015-02-27 08:35:09 +00:00
|
|
|
This mount option significantly reduces writes
|
2015-02-27 07:59:18 +00:00
|
|
|
needed to update the inode's timestamps, especially mtime and atime.
|
|
|
|
However, in the event of a system crash, the atime and mtime fields
|
|
|
|
on disk might be out of date by up to 24 hours.
|
|
|
|
|
|
|
|
Examples of workloads where this option could be of significant benefit
|
|
|
|
include frequent random writes to preallocated files,
|
|
|
|
as well as cases where the
|
|
|
|
.B MS_STRICTATIME
|
|
|
|
mount option is also enabled.
|
2015-03-03 07:16:35 +00:00
|
|
|
(The advantage of combining
|
|
|
|
.BR MS_STRICTATIME
|
|
|
|
and
|
|
|
|
.BR MS_LAZYTIME
|
2015-02-27 07:59:18 +00:00
|
|
|
is that
|
|
|
|
.BR stat (2)
|
|
|
|
will return the correctly updated atime, but the atime updates
|
2015-02-27 08:35:09 +00:00
|
|
|
will be flushed to disk only in the cases listed above.)
|
2015-02-20 08:50:01 +00:00
|
|
|
.TP
|
2004-11-03 13:51:07 +00:00
|
|
|
.B MS_MANDLOCK
|
intro.1, time.1, access.2, acct.2, alloc_hugepages.2, bind.2, chdir.2, chmod.2, chown.2, chroot.2, clone.2, close.2, execve.2, fallocate.2, fcntl.2, getdents.2, getrusage.2, getxattr.2, init_module.2, inotify_add_watch.2, ioprio_set.2, kcmp.2, link.2, listxattr.2, lseek.2, madvise.2, mkdir.2, mknod.2, mmap.2, mount.2, move_pages.2, msgctl.2, nfsservctl.2, open.2, pivot_root.2, quotactl.2, read.2, readlink.2, removexattr.2, rename.2, rmdir.2, semctl.2, setfsgid.2, setfsuid.2, setresuid.2, setuid.2, setup.2, setxattr.2, shmctl.2, splice.2, spu_create.2, stat.2, statfs.2, swapon.2, symlink.2, sync.2, sync_file_range.2, sysfs.2, truncate.2, umount.2, unlink.2, unshare.2, ustat.2, utime.2, utimensat.2, write.2, btree.3, errno.3, fexecve.3, ftw.3, futimes.3, get_nprocs_conf.3, getcwd.3, getdirentries.3, getmntent.3, glob.3, mkfifo.3, mq_open.3, readdir.3, realpath.3, recno.3, remove.3, sem_open.3, shm_open.3, statvfs.3, sysconf.3, telldir.3, tmpfile.3, cciss.4, initrd.4, pts.4, sk98lin.4, vcs.4, core.5, filesystems.5, proc.5, boot.7, bootparam.7, capabilities.7, cpuset.7, credentials.7, feature_test_macros.7, fifo.7, hier.7, inotify.7, intro.7, mq_overview.7, path_resolution.7, pipe.7, sem_overview.7, shm_overview.7, spufs.7, symlink.7, unix.7, uri.7, sync.8: Global fix: s/file system/filesystem/
Notwithstanding 24d01c530c5a3f75217543d02bf6712395e5f90c,
"filesystem" is the form used by the great majority of man pages
outside the man-pages project and in a number of other sources,
so let's go with that.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 08:07:57 +00:00
|
|
|
Permit mandatory locking on files in this filesystem.
|
2004-11-03 13:51:07 +00:00
|
|
|
(Mandatory locking must still be enabled on a per-file basis,
|
|
|
|
as described in
|
|
|
|
.BR fcntl (2).)
|
2016-04-18 12:16:39 +00:00
|
|
|
Since Linux 4.5,
|
|
|
|
.\" commit 95ace75414f312f9a7b93d873f386987b92a5301
|
|
|
|
this mount option requires the
|
|
|
|
.B CAP_SYS_ADMIN
|
|
|
|
capability.
|
adjtimex.2, bind.2, cacheflush.2, clone.2, fallocate.2, fanotify_init.2, fanotify_mark.2, flock.2, futex.2, getdents.2, getpriority.2, getrlimit.2, gettid.2, gettimeofday.2, ioprio_set.2, kexec_load.2, migrate_pages.2, modify_ldt.2, mount.2, move_pages.2, mprotect.2, msgop.2, nfsservctl.2, perf_event_open.2, pread.2, ptrace.2, recvmmsg.2, rename.2, restart_syscall.2, sched_setattr.2, send.2, shmop.2, shutdown.2, sigaction.2, signalfd.2, syscalls.2, timer_create.2, timerfd_create.2, tkill.2, vmsplice.2, wait.2, aio_init.3, confstr.3, exit.3, fmemopen.3, fopen.3, getaddrinfo.3, getauxval.3, getspnam.3, isalpha.3, isatty.3, mallinfo.3, malloc.3, mallopt.3, psignal.3, pthread_attr_setinheritsched.3, qecvt.3, queue.3, rtnetlink.3, strerror.3, strftime.3, toupper.3, towlower.3, towupper.3, initrd.4, locale.5, proc.5, bootparam.7, capabilities.7, ddp.7, fanotify.7, icmp.7, inotify.7, ip.7, ipv6.7, netdevice.7, netlink.7, path_resolution.7, rtld-audit.7, rtnetlink.7, sched.7, signal.7, socket.7, svipc.7, tcp.7, unix.7, ld.so.8: srcfix: Update FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-21 21:47:44 +00:00
|
|
|
.\" FIXME Describe the MS_MOVE flag in more detail
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.B MS_NOATIME
|
intro.1, time.1, access.2, acct.2, alloc_hugepages.2, bind.2, chdir.2, chmod.2, chown.2, chroot.2, clone.2, close.2, execve.2, fallocate.2, fcntl.2, getdents.2, getrusage.2, getxattr.2, init_module.2, inotify_add_watch.2, ioprio_set.2, kcmp.2, link.2, listxattr.2, lseek.2, madvise.2, mkdir.2, mknod.2, mmap.2, mount.2, move_pages.2, msgctl.2, nfsservctl.2, open.2, pivot_root.2, quotactl.2, read.2, readlink.2, removexattr.2, rename.2, rmdir.2, semctl.2, setfsgid.2, setfsuid.2, setresuid.2, setuid.2, setup.2, setxattr.2, shmctl.2, splice.2, spu_create.2, stat.2, statfs.2, swapon.2, symlink.2, sync.2, sync_file_range.2, sysfs.2, truncate.2, umount.2, unlink.2, unshare.2, ustat.2, utime.2, utimensat.2, write.2, btree.3, errno.3, fexecve.3, ftw.3, futimes.3, get_nprocs_conf.3, getcwd.3, getdirentries.3, getmntent.3, glob.3, mkfifo.3, mq_open.3, readdir.3, realpath.3, recno.3, remove.3, sem_open.3, shm_open.3, statvfs.3, sysconf.3, telldir.3, tmpfile.3, cciss.4, initrd.4, pts.4, sk98lin.4, vcs.4, core.5, filesystems.5, proc.5, boot.7, bootparam.7, capabilities.7, cpuset.7, credentials.7, feature_test_macros.7, fifo.7, hier.7, inotify.7, intro.7, mq_overview.7, path_resolution.7, pipe.7, sem_overview.7, shm_overview.7, spufs.7, symlink.7, unix.7, uri.7, sync.8: Global fix: s/file system/filesystem/
Notwithstanding 24d01c530c5a3f75217543d02bf6712395e5f90c,
"filesystem" is the form used by the great majority of man pages
outside the man-pages project and in a number of other sources,
so let's go with that.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 08:07:57 +00:00
|
|
|
Do not update access times for (all types of) files on this filesystem.
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.B MS_NODEV
|
intro.1, time.1, access.2, acct.2, alloc_hugepages.2, bind.2, chdir.2, chmod.2, chown.2, chroot.2, clone.2, close.2, execve.2, fallocate.2, fcntl.2, getdents.2, getrusage.2, getxattr.2, init_module.2, inotify_add_watch.2, ioprio_set.2, kcmp.2, link.2, listxattr.2, lseek.2, madvise.2, mkdir.2, mknod.2, mmap.2, mount.2, move_pages.2, msgctl.2, nfsservctl.2, open.2, pivot_root.2, quotactl.2, read.2, readlink.2, removexattr.2, rename.2, rmdir.2, semctl.2, setfsgid.2, setfsuid.2, setresuid.2, setuid.2, setup.2, setxattr.2, shmctl.2, splice.2, spu_create.2, stat.2, statfs.2, swapon.2, symlink.2, sync.2, sync_file_range.2, sysfs.2, truncate.2, umount.2, unlink.2, unshare.2, ustat.2, utime.2, utimensat.2, write.2, btree.3, errno.3, fexecve.3, ftw.3, futimes.3, get_nprocs_conf.3, getcwd.3, getdirentries.3, getmntent.3, glob.3, mkfifo.3, mq_open.3, readdir.3, realpath.3, recno.3, remove.3, sem_open.3, shm_open.3, statvfs.3, sysconf.3, telldir.3, tmpfile.3, cciss.4, initrd.4, pts.4, sk98lin.4, vcs.4, core.5, filesystems.5, proc.5, boot.7, bootparam.7, capabilities.7, cpuset.7, credentials.7, feature_test_macros.7, fifo.7, hier.7, inotify.7, intro.7, mq_overview.7, path_resolution.7, pipe.7, sem_overview.7, shm_overview.7, spufs.7, symlink.7, unix.7, uri.7, sync.8: Global fix: s/file system/filesystem/
Notwithstanding 24d01c530c5a3f75217543d02bf6712395e5f90c,
"filesystem" is the form used by the great majority of man pages
outside the man-pages project and in a number of other sources,
so let's go with that.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 08:07:57 +00:00
|
|
|
Do not allow access to devices (special files) on this filesystem.
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.B MS_NODIRATIME
|
intro.1, time.1, access.2, acct.2, alloc_hugepages.2, bind.2, chdir.2, chmod.2, chown.2, chroot.2, clone.2, close.2, execve.2, fallocate.2, fcntl.2, getdents.2, getrusage.2, getxattr.2, init_module.2, inotify_add_watch.2, ioprio_set.2, kcmp.2, link.2, listxattr.2, lseek.2, madvise.2, mkdir.2, mknod.2, mmap.2, mount.2, move_pages.2, msgctl.2, nfsservctl.2, open.2, pivot_root.2, quotactl.2, read.2, readlink.2, removexattr.2, rename.2, rmdir.2, semctl.2, setfsgid.2, setfsuid.2, setresuid.2, setuid.2, setup.2, setxattr.2, shmctl.2, splice.2, spu_create.2, stat.2, statfs.2, swapon.2, symlink.2, sync.2, sync_file_range.2, sysfs.2, truncate.2, umount.2, unlink.2, unshare.2, ustat.2, utime.2, utimensat.2, write.2, btree.3, errno.3, fexecve.3, ftw.3, futimes.3, get_nprocs_conf.3, getcwd.3, getdirentries.3, getmntent.3, glob.3, mkfifo.3, mq_open.3, readdir.3, realpath.3, recno.3, remove.3, sem_open.3, shm_open.3, statvfs.3, sysconf.3, telldir.3, tmpfile.3, cciss.4, initrd.4, pts.4, sk98lin.4, vcs.4, core.5, filesystems.5, proc.5, boot.7, bootparam.7, capabilities.7, cpuset.7, credentials.7, feature_test_macros.7, fifo.7, hier.7, inotify.7, intro.7, mq_overview.7, path_resolution.7, pipe.7, sem_overview.7, shm_overview.7, spufs.7, symlink.7, unix.7, uri.7, sync.8: Global fix: s/file system/filesystem/
Notwithstanding 24d01c530c5a3f75217543d02bf6712395e5f90c,
"filesystem" is the form used by the great majority of man pages
outside the man-pages project and in a number of other sources,
so let's go with that.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 08:07:57 +00:00
|
|
|
Do not update access times for directories on this filesystem.
|
2007-12-17 14:21:56 +00:00
|
|
|
This flag provides a subset of the functionality provided by
|
|
|
|
.BR MS_NOATIME ;
|
|
|
|
that is,
|
|
|
|
.BR MS_NOATIME
|
|
|
|
implies
|
|
|
|
.BR MS_NODIRATIME .
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.B MS_NOEXEC
|
intro.1, time.1, access.2, acct.2, alloc_hugepages.2, bind.2, chdir.2, chmod.2, chown.2, chroot.2, clone.2, close.2, execve.2, fallocate.2, fcntl.2, getdents.2, getrusage.2, getxattr.2, init_module.2, inotify_add_watch.2, ioprio_set.2, kcmp.2, link.2, listxattr.2, lseek.2, madvise.2, mkdir.2, mknod.2, mmap.2, mount.2, move_pages.2, msgctl.2, nfsservctl.2, open.2, pivot_root.2, quotactl.2, read.2, readlink.2, removexattr.2, rename.2, rmdir.2, semctl.2, setfsgid.2, setfsuid.2, setresuid.2, setuid.2, setup.2, setxattr.2, shmctl.2, splice.2, spu_create.2, stat.2, statfs.2, swapon.2, symlink.2, sync.2, sync_file_range.2, sysfs.2, truncate.2, umount.2, unlink.2, unshare.2, ustat.2, utime.2, utimensat.2, write.2, btree.3, errno.3, fexecve.3, ftw.3, futimes.3, get_nprocs_conf.3, getcwd.3, getdirentries.3, getmntent.3, glob.3, mkfifo.3, mq_open.3, readdir.3, realpath.3, recno.3, remove.3, sem_open.3, shm_open.3, statvfs.3, sysconf.3, telldir.3, tmpfile.3, cciss.4, initrd.4, pts.4, sk98lin.4, vcs.4, core.5, filesystems.5, proc.5, boot.7, bootparam.7, capabilities.7, cpuset.7, credentials.7, feature_test_macros.7, fifo.7, hier.7, inotify.7, intro.7, mq_overview.7, path_resolution.7, pipe.7, sem_overview.7, shm_overview.7, spufs.7, symlink.7, unix.7, uri.7, sync.8: Global fix: s/file system/filesystem/
Notwithstanding 24d01c530c5a3f75217543d02bf6712395e5f90c,
"filesystem" is the form used by the great majority of man pages
outside the man-pages project and in a number of other sources,
so let's go with that.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 08:07:57 +00:00
|
|
|
Do not allow programs to be executed from this filesystem.
|
|
|
|
.\" (Possibly useful for a filesystem that contains non-Linux executables.
|
2007-06-08 11:56:22 +00:00
|
|
|
.\" Often used as a security feature, e.g., to make sure that restricted
|
2004-11-03 13:51:07 +00:00
|
|
|
.\" users cannot execute files uploaded using ftp or so.)
|
|
|
|
.TP
|
|
|
|
.B MS_NOSUID
|
2016-05-10 19:01:10 +00:00
|
|
|
Do not honor set-user-ID and set-group-ID bits or file capabilities
|
|
|
|
when executing programs from this filesystem.
|
2005-07-18 14:25:42 +00:00
|
|
|
.\" (This is a security feature to prevent users executing set-user-ID and
|
|
|
|
.\" set-group-ID programs from removable disk devices.)
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.B MS_RDONLY
|
intro.1, time.1, access.2, acct.2, alloc_hugepages.2, bind.2, chdir.2, chmod.2, chown.2, chroot.2, clone.2, close.2, execve.2, fallocate.2, fcntl.2, getdents.2, getrusage.2, getxattr.2, init_module.2, inotify_add_watch.2, ioprio_set.2, kcmp.2, link.2, listxattr.2, lseek.2, madvise.2, mkdir.2, mknod.2, mmap.2, mount.2, move_pages.2, msgctl.2, nfsservctl.2, open.2, pivot_root.2, quotactl.2, read.2, readlink.2, removexattr.2, rename.2, rmdir.2, semctl.2, setfsgid.2, setfsuid.2, setresuid.2, setuid.2, setup.2, setxattr.2, shmctl.2, splice.2, spu_create.2, stat.2, statfs.2, swapon.2, symlink.2, sync.2, sync_file_range.2, sysfs.2, truncate.2, umount.2, unlink.2, unshare.2, ustat.2, utime.2, utimensat.2, write.2, btree.3, errno.3, fexecve.3, ftw.3, futimes.3, get_nprocs_conf.3, getcwd.3, getdirentries.3, getmntent.3, glob.3, mkfifo.3, mq_open.3, readdir.3, realpath.3, recno.3, remove.3, sem_open.3, shm_open.3, statvfs.3, sysconf.3, telldir.3, tmpfile.3, cciss.4, initrd.4, pts.4, sk98lin.4, vcs.4, core.5, filesystems.5, proc.5, boot.7, bootparam.7, capabilities.7, cpuset.7, credentials.7, feature_test_macros.7, fifo.7, hier.7, inotify.7, intro.7, mq_overview.7, path_resolution.7, pipe.7, sem_overview.7, shm_overview.7, spufs.7, symlink.7, unix.7, uri.7, sync.8: Global fix: s/file system/filesystem/
Notwithstanding 24d01c530c5a3f75217543d02bf6712395e5f90c,
"filesystem" is the form used by the great majority of man pages
outside the man-pages project and in a number of other sources,
so let's go with that.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 08:07:57 +00:00
|
|
|
Mount filesystem read-only.
|
2016-06-04 15:38:59 +00:00
|
|
|
.TP
|
|
|
|
.BR MS_REC " (since Linux 2.4.11)"
|
|
|
|
Used in conjunction with
|
|
|
|
.BR MS_BIND
|
|
|
|
to create a recursive bind mount,
|
|
|
|
and in conjunction with the propagation type flags to recursively change
|
|
|
|
the propagation type of all of the mounts in a subtree.
|
|
|
|
See below for further details.
|
2007-04-12 22:42:49 +00:00
|
|
|
.TP
|
2014-01-21 02:40:40 +00:00
|
|
|
.BR MS_RELATIME " (since Linux 2.6.20)"
|
intro.1, time.1, access.2, acct.2, alloc_hugepages.2, bind.2, chdir.2, chmod.2, chown.2, chroot.2, clone.2, close.2, execve.2, fallocate.2, fcntl.2, getdents.2, getrusage.2, getxattr.2, init_module.2, inotify_add_watch.2, ioprio_set.2, kcmp.2, link.2, listxattr.2, lseek.2, madvise.2, mkdir.2, mknod.2, mmap.2, mount.2, move_pages.2, msgctl.2, nfsservctl.2, open.2, pivot_root.2, quotactl.2, read.2, readlink.2, removexattr.2, rename.2, rmdir.2, semctl.2, setfsgid.2, setfsuid.2, setresuid.2, setuid.2, setup.2, setxattr.2, shmctl.2, splice.2, spu_create.2, stat.2, statfs.2, swapon.2, symlink.2, sync.2, sync_file_range.2, sysfs.2, truncate.2, umount.2, unlink.2, unshare.2, ustat.2, utime.2, utimensat.2, write.2, btree.3, errno.3, fexecve.3, ftw.3, futimes.3, get_nprocs_conf.3, getcwd.3, getdirentries.3, getmntent.3, glob.3, mkfifo.3, mq_open.3, readdir.3, realpath.3, recno.3, remove.3, sem_open.3, shm_open.3, statvfs.3, sysconf.3, telldir.3, tmpfile.3, cciss.4, initrd.4, pts.4, sk98lin.4, vcs.4, core.5, filesystems.5, proc.5, boot.7, bootparam.7, capabilities.7, cpuset.7, credentials.7, feature_test_macros.7, fifo.7, hier.7, inotify.7, intro.7, mq_overview.7, path_resolution.7, pipe.7, sem_overview.7, shm_overview.7, spufs.7, symlink.7, unix.7, uri.7, sync.8: Global fix: s/file system/filesystem/
Notwithstanding 24d01c530c5a3f75217543d02bf6712395e5f90c,
"filesystem" is the form used by the great majority of man pages
outside the man-pages project and in a number of other sources,
so let's go with that.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 08:07:57 +00:00
|
|
|
When a file on this filesystem is accessed,
|
intro.1, _syscall.2, access.2, arch_prctl.2, cacheflush.2, chown.2, clock_getres.2, clone.2, create_module.2, fcntl.2, flock.2, get_kernel_syms.2, get_robust_list.2, get_thread_area.2, getcpu.2, getpriority.2, getrlimit.2, getrusage.2, ioprio_set.2, kexec_load.2, madvise.2, mbind.2, migrate_pages.2, mknod.2, mmap.2, mount.2, move_pages.2, mprotect.2, open.2, pause.2, pciconfig_read.2, perf_event_open.2, prctl.2, ptrace.2, query_module.2, read.2, reboot.2, recv.2, s390_runtime_instr.2, sched_setscheduler.2, select_tut.2, send.2, set_mempolicy.2, setfsgid.2, setfsuid.2, sigaction.2, spu_create.2, spu_run.2, stime.2, swapon.2, syslog.2, timer_create.2, timer_getoverrun.2, times.2, tkill.2, umount.2, unimplemented.2, ustat.2, vm86.2, wait.2, abs.3, aio_read.3, aio_write.3, bsd_signal.3, catgets.3, clearenv.3, cmsg.3, dbopen.3, dirfd.3, dlopen.3, exec.3, fenv.3, ferror.3, fmemopen.3, fnmatch.3, fopen.3, futimes.3, getaddrinfo.3, getifaddrs.3, getipnodebyname.3, hsearch.3, if_nameindex.3, inet_pton.3, mblen.3, mbrlen.3, mbsrtowcs.3, mbtowc.3, mcheck.3, memfrob.3, mq_notify.3, netlink.3, posix_memalign.3, printf.3, pthread_attr_setscope.3, pthread_cleanup_push.3, pthread_kill_other_threads_np.3, pthread_self.3, pthread_setcancelstate.3, pthread_setconcurrency.3, raise.3, resolver.3, rpc.3, rtime.3, rtnetlink.3, scanf.3, setbuf.3, setnetgrent.3, shm_open.3, sigpause.3, sigset.3, sigwait.3, sockatmark.3, strcasecmp.3, strcmp.3, strdup.3, strftime.3, strptime.3, strsignal.3, strverscmp.3, sysv_signal.3, termios.3, wcrtomb.3, wcsnlen.3, wcsnrtombs.3, wcsrtombs.3, wctomb.3, wprintf.3, console_codes.4, cpuid.4, msr.4, rtc.4, sk98lin.4, st.4, tty.4, charmap.5, core.5, elf.5, hosts.equiv.5, proc.5, resolv.conf.5, services.5, slabinfo.5, arp.7, bootparam.7, capabilities.7, charsets.7, cpuset.7, ddp.7, epoll.7, feature_test_macros.7, futex.7, hier.7, icmp.7, inotify.7, ip.7, ipv6.7, man-pages.7, mdoc.7, mdoc.samples.7, netdevice.7, netlink.7, numa.7, packet.7, path_resolution.7, posixoptions.7, pthreads.7, raw.7, rtld-audit.7, rtnetlink.7, sem_overview.7, sigevent.7, socket.7, spufs.7, tcp.7, udp.7, unicode.7, uri.7, utf-8.7, intro.8, ldconfig.8, sync.8: Global fix: fix placement of word "only"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-03-31 08:53:00 +00:00
|
|
|
update the file's last access time (atime) only if the current value
|
2008-09-18 12:30:37 +00:00
|
|
|
of atime is less than or equal to the file's last modification time (mtime)
|
2007-02-10 17:37:00 +00:00
|
|
|
or last status change time (ctime).
|
|
|
|
This option is useful for programs, such as
|
|
|
|
.BR mutt (1),
|
|
|
|
that need to know when a file has been read since it was last modified.
|
2009-06-26 05:53:25 +00:00
|
|
|
Since Linux 2.6.30, the kernel defaults to the behavior provided
|
|
|
|
by this flag (unless
|
|
|
|
.BR MS_NOATIME
|
|
|
|
was specified), and the
|
|
|
|
.B MS_STRICTATIME
|
|
|
|
flag is required to obtain traditional semantics.
|
|
|
|
In addition, since Linux 2.6.30,
|
|
|
|
the file's last access time is always updated if it
|
|
|
|
is more than 1 day old.
|
|
|
|
.\" Matthew Garrett notes in the patch that added this behavior
|
|
|
|
.\" that this lets utilities such as tmpreaper (which deletes
|
2014-01-15 04:28:06 +00:00
|
|
|
.\" files based on last access time) work correctly.
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
2016-06-04 13:44:46 +00:00
|
|
|
.BR MS_SILENT " (since Linux 2.6.17)"
|
|
|
|
Suppress the display of certain
|
|
|
|
.RI ( printk ())
|
|
|
|
warning messages in the kernel log.
|
|
|
|
This flag supersedes the misnamed and obsolete
|
|
|
|
.BR MS_VERBOSE
|
|
|
|
flag (available since Linux 2.4.12), which has the same meaning.
|
|
|
|
.TP
|
|
|
|
.BR MS_STRICTATIME " (since Linux 2.6.30)"
|
|
|
|
Always update the last access time (atime) when files on this
|
|
|
|
filesystem are accessed.
|
|
|
|
(This was the default behavior before Linux 2.6.30.)
|
|
|
|
Specifying this flag overrides the effect of setting the
|
|
|
|
.BR MS_NOATIME
|
|
|
|
and
|
|
|
|
.BR MS_RELATIME
|
|
|
|
flags.
|
|
|
|
.TP
|
|
|
|
.B MS_SYNCHRONOUS
|
|
|
|
Make writes on this filesystem synchronous (as though
|
|
|
|
the
|
|
|
|
.B O_SYNC
|
|
|
|
flag to
|
|
|
|
.BR open (2)
|
|
|
|
was specified for all file opens to this filesystem).
|
|
|
|
.PP
|
|
|
|
From Linux 2.4 onward, the
|
|
|
|
.BR MS_NODEV ", " MS_NOEXEC ", and " MS_NOSUID
|
|
|
|
flags are settable on a per-mount-point basis.
|
|
|
|
From kernel 2.6.16 onward,
|
|
|
|
.B MS_NOATIME
|
|
|
|
and
|
|
|
|
.B MS_NODIRATIME
|
|
|
|
are also settable on a per-mount-point basis.
|
|
|
|
The
|
|
|
|
.B MS_RELATIME
|
|
|
|
flag is also settable on a per-mount-point basis.
|
|
|
|
.\"
|
|
|
|
.SS Remounting an existing mount
|
|
|
|
An existing mount may be remounted by specifying
|
2004-11-03 13:51:07 +00:00
|
|
|
.B MS_REMOUNT
|
2016-06-04 13:44:46 +00:00
|
|
|
in
|
|
|
|
.IR mountflags .
|
2007-08-27 10:06:53 +00:00
|
|
|
This allows you to change the
|
2004-11-03 13:51:07 +00:00
|
|
|
.I mountflags
|
|
|
|
and
|
|
|
|
.I data
|
intro.1, time.1, access.2, acct.2, alloc_hugepages.2, bind.2, chdir.2, chmod.2, chown.2, chroot.2, clone.2, close.2, execve.2, fallocate.2, fcntl.2, getdents.2, getrusage.2, getxattr.2, init_module.2, inotify_add_watch.2, ioprio_set.2, kcmp.2, link.2, listxattr.2, lseek.2, madvise.2, mkdir.2, mknod.2, mmap.2, mount.2, move_pages.2, msgctl.2, nfsservctl.2, open.2, pivot_root.2, quotactl.2, read.2, readlink.2, removexattr.2, rename.2, rmdir.2, semctl.2, setfsgid.2, setfsuid.2, setresuid.2, setuid.2, setup.2, setxattr.2, shmctl.2, splice.2, spu_create.2, stat.2, statfs.2, swapon.2, symlink.2, sync.2, sync_file_range.2, sysfs.2, truncate.2, umount.2, unlink.2, unshare.2, ustat.2, utime.2, utimensat.2, write.2, btree.3, errno.3, fexecve.3, ftw.3, futimes.3, get_nprocs_conf.3, getcwd.3, getdirentries.3, getmntent.3, glob.3, mkfifo.3, mq_open.3, readdir.3, realpath.3, recno.3, remove.3, sem_open.3, shm_open.3, statvfs.3, sysconf.3, telldir.3, tmpfile.3, cciss.4, initrd.4, pts.4, sk98lin.4, vcs.4, core.5, filesystems.5, proc.5, boot.7, bootparam.7, capabilities.7, cpuset.7, credentials.7, feature_test_macros.7, fifo.7, hier.7, inotify.7, intro.7, mq_overview.7, path_resolution.7, pipe.7, sem_overview.7, shm_overview.7, spufs.7, symlink.7, unix.7, uri.7, sync.8: Global fix: s/file system/filesystem/
Notwithstanding 24d01c530c5a3f75217543d02bf6712395e5f90c,
"filesystem" is the form used by the great majority of man pages
outside the man-pages project and in a number of other sources,
so let's go with that.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 08:07:57 +00:00
|
|
|
of an existing mount without having to unmount and remount the filesystem.
|
2004-11-03 13:51:07 +00:00
|
|
|
.I target
|
2012-07-05 05:48:15 +00:00
|
|
|
should be the same value specified in the initial
|
2004-11-03 13:51:07 +00:00
|
|
|
.BR mount ()
|
2016-06-04 14:11:50 +00:00
|
|
|
call.
|
|
|
|
|
|
|
|
The
|
2012-07-05 05:48:15 +00:00
|
|
|
.I source
|
|
|
|
and
|
2004-11-03 13:51:07 +00:00
|
|
|
.I filesystemtype
|
2016-06-04 14:11:50 +00:00
|
|
|
arguments are ignored.
|
2016-06-04 13:44:46 +00:00
|
|
|
|
2014-09-11 13:52:05 +00:00
|
|
|
The
|
|
|
|
.I mountflags
|
|
|
|
and
|
|
|
|
.I data
|
|
|
|
arguments should match the values used in the original
|
|
|
|
.BR mount ()
|
|
|
|
call, except for those parameters that are being deliberately changed.
|
2006-04-25 09:32:44 +00:00
|
|
|
|
|
|
|
The following
|
2007-04-12 22:42:49 +00:00
|
|
|
.I mountflags
|
2006-04-25 09:32:44 +00:00
|
|
|
can be changed:
|
2016-06-05 13:49:56 +00:00
|
|
|
.BR MS_LAZYTIME ,
|
2016-06-05 11:18:05 +00:00
|
|
|
.BR MS_MANDLOCK ,
|
|
|
|
.BR MS_NOATIME ,
|
2006-04-25 09:32:44 +00:00
|
|
|
.BR MS_NODEV ,
|
2016-06-05 11:18:05 +00:00
|
|
|
.BR MS_NODIRATIME ,
|
|
|
|
.BR MS_NOEXEC ,
|
|
|
|
.BR MS_NOSUID ,
|
2016-06-05 13:49:56 +00:00
|
|
|
.BR MS_RELATIME ,
|
2016-06-05 11:18:05 +00:00
|
|
|
.BR MS_RDONLY ,
|
2016-06-03 16:05:44 +00:00
|
|
|
and
|
2016-06-05 11:18:05 +00:00
|
|
|
.BR MS_SYNCHRONOUS .
|
2016-06-05 13:49:07 +00:00
|
|
|
Attempts to change the setting of the
|
|
|
|
.\" See the definition of MS_RMT_MASK in include/uapi/linux/fs.h
|
|
|
|
.BR MS_DIRSYNC
|
|
|
|
flag during a remount are silently ignored.
|
2016-06-03 16:12:31 +00:00
|
|
|
|
2016-06-04 11:40:02 +00:00
|
|
|
Since Linux 3.17,
|
|
|
|
.\" commit ffbc6f0ead47fa5a1dc9642b0331cb75c20a640e
|
|
|
|
if none of
|
|
|
|
.BR MS_NOATIME ,
|
|
|
|
.BR MS_NODIRATIME ,
|
|
|
|
.BR MS_RELATIME ,
|
|
|
|
or
|
|
|
|
.BR MS_STRICTATIME
|
|
|
|
is specified in
|
|
|
|
.IR mountflags ,
|
|
|
|
then the remount operation preserves the existing values of these flags
|
|
|
|
(rather than defaulting to
|
|
|
|
.BR MS_RELATIME ).
|
|
|
|
|
2016-06-03 16:12:31 +00:00
|
|
|
Since Linux 2.6.26, this flag can also be used to make
|
|
|
|
.\" See https://lwn.net/Articles/281157/
|
|
|
|
an existing bind mount read-only by specifying
|
|
|
|
.IR mountflags
|
|
|
|
as:
|
|
|
|
|
|
|
|
MS_REMOUNT | MS_BIND | MS_RDONLY
|
|
|
|
|
|
|
|
Note that only the
|
|
|
|
.BR MS_RDONLY
|
|
|
|
setting of the bind mount can be changed in this manner.
|
2016-06-04 13:44:46 +00:00
|
|
|
.\"
|
|
|
|
.SS Creating a bind mount
|
|
|
|
If
|
|
|
|
.I mountflags
|
|
|
|
includes
|
|
|
|
.BR MS_BIND
|
|
|
|
(available since Linux 2.4),
|
|
|
|
.\" since 2.4.0-test9
|
|
|
|
then perform a bind mount.
|
|
|
|
A bind mount makes a file or a directory subtree visible at
|
|
|
|
another point within the single directory hierarchy.
|
|
|
|
Bind mounts may cross filesystem boundaries and span
|
|
|
|
.BR chroot (2)
|
|
|
|
jails.
|
|
|
|
|
|
|
|
The
|
|
|
|
.IR filesystemtype
|
2009-06-26 05:53:25 +00:00
|
|
|
and
|
2016-06-04 13:44:46 +00:00
|
|
|
.IR data
|
|
|
|
arguments are ignored.
|
|
|
|
|
|
|
|
The remaining bits in the
|
|
|
|
.I mountflags
|
|
|
|
argument are also ignored, with the exception of
|
|
|
|
.BR MS_REC .
|
|
|
|
(The bind mount has the same mount options as
|
|
|
|
the underlying mount point.)
|
|
|
|
However, see the discussion of remounting above,
|
|
|
|
for a method of making an existing bind mount read-only.
|
2016-06-04 15:38:59 +00:00
|
|
|
|
|
|
|
By default, when a directory is bind mounted,
|
|
|
|
only that directory is mounted;
|
|
|
|
if there are any submounts under the directory tree,
|
|
|
|
they are not bind mounted.
|
|
|
|
If the
|
|
|
|
.BR MS_REC
|
|
|
|
flag is also specified, then a recursive bind mount operation is performed:
|
|
|
|
all submounts under the
|
|
|
|
.I source
|
|
|
|
subtree (other than unbindable mounts)
|
|
|
|
are also bind mounted at the corresponding location in the
|
|
|
|
.I target
|
|
|
|
subtree.
|
2016-06-04 13:44:46 +00:00
|
|
|
.\"
|
|
|
|
.SS Changing the propagation type of an existing mount
|
2016-06-04 15:16:29 +00:00
|
|
|
If
|
|
|
|
.IR mountflags
|
|
|
|
includes one of
|
|
|
|
.BR MS_SHARED ,
|
|
|
|
.BR MS_PRIVATE ,
|
|
|
|
.BR MS_SLAVE ,
|
|
|
|
or
|
|
|
|
.BR MS_UNBINDABLE
|
|
|
|
(all available since Linux 2.6.15),
|
|
|
|
then the propagation type of an existing mount is changed.
|
|
|
|
If more than one of these flags is specified, an error results.
|
|
|
|
|
|
|
|
The only flags that can be used with changing the propagation type are
|
|
|
|
.BR MS_REC
|
|
|
|
and
|
|
|
|
.BR MS_SILENT .
|
|
|
|
|
|
|
|
The
|
|
|
|
.IR source ,
|
|
|
|
.IR filesystemtype ,
|
|
|
|
and
|
|
|
|
.IR data
|
|
|
|
arguments are ignored.
|
|
|
|
|
|
|
|
The meanings of the propagation type flags are as follows:
|
|
|
|
.TP
|
|
|
|
.BR MS_SHARED
|
|
|
|
Make this mount point shared.
|
|
|
|
Mount and unmount events immediately under this mount point will propagate
|
|
|
|
to the other mount points that are members of this mount's peer group.
|
|
|
|
Propagation here means that the same mount or unmount will automatically
|
|
|
|
occur under all of the other mount points in the peer group.
|
|
|
|
Conversely, mount and unmount events that take place under
|
|
|
|
peer mount points will propagate to this mount point.
|
|
|
|
.TP
|
|
|
|
.BR MS_PRIVATE
|
|
|
|
Make this mount point private.
|
|
|
|
Mount and unmount events do not propagate into or out of this mount point.
|
|
|
|
This is the default propagation type for newly created mount points.
|
|
|
|
.TP
|
|
|
|
.BR MS_SLAVE
|
|
|
|
If this is a shared mount point that is a member of a peer group
|
|
|
|
that contains other members, convert it to a slave mount.
|
|
|
|
If this is a shared mount point that is a member of a peer group
|
|
|
|
that contains no other members, convert it to a private mount.
|
|
|
|
Otherwise, the propagation type of the mount point is left unchanged.
|
|
|
|
|
|
|
|
When a mount point is a slave,
|
|
|
|
mount and unmount events propagate into this mount point from
|
|
|
|
the (master) shared peer group of which it was formerly a member.
|
|
|
|
Mount and unmount events under this mount point do not propagate to any peer.
|
|
|
|
|
|
|
|
A mount point can be the slave of another peer group
|
|
|
|
while at the same time sharing mount and unmount events
|
|
|
|
with a peer group of which it is a member.
|
|
|
|
.TP
|
|
|
|
.BR MS_UNBINDABLE
|
|
|
|
Make this mount unbindable.
|
|
|
|
This is like a private mount,
|
|
|
|
and in addition this mount can't be bind mounted.
|
|
|
|
When a recursive bind mount
|
arch_prctl.2, execveat.2, fanotify_mark.2, fcntl.2, fork.2, madvise.2, mknod.2, mmap.2, modify_ldt.2, mount.2, open.2, prctl.2, ptrace.2, restart_syscall.2, seccomp.2, semop.2, set_thread_area.2, symlink.2, umount.2, unlink.2, error.3, getnetent.3, getprotoent.3, getservent.3, getutent.3, glob.3, login.3, setjmp.3, setnetgrent.3, wordexp.3, epoll.7: Remove section number from page self reference
Fix places where pages refer to the function that they describe
and include a section number in that reference. Such references
cause some HTML-rendering tools to create self-references in the
page.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-08-07 16:40:35 +00:00
|
|
|
.RB ( mount ()
|
2016-06-04 15:16:29 +00:00
|
|
|
with the
|
|
|
|
.BR MS_BIND
|
|
|
|
and
|
|
|
|
.BR MS_REC
|
|
|
|
flags) is performed on a directory subtree,
|
|
|
|
any bind mounts within the subtree are automatically pruned
|
|
|
|
(i.e., not replicated)
|
|
|
|
when replicating that subtree to produce the target subtree.
|
2016-06-04 15:38:59 +00:00
|
|
|
.PP
|
|
|
|
By default, changing the propagation type affects only the
|
|
|
|
.I target
|
|
|
|
mount point.
|
|
|
|
If the
|
|
|
|
.B MS_REC
|
|
|
|
flag is also specified in
|
|
|
|
.IR mountflags ,
|
|
|
|
then the propagation type of all mount points under
|
|
|
|
.IR target
|
|
|
|
is also changed.
|
2016-06-26 15:40:50 +00:00
|
|
|
|
|
|
|
For further details regarding mount propagation types, see
|
|
|
|
.BR mount_namespaces (7).
|
2016-06-04 13:44:46 +00:00
|
|
|
.\"
|
|
|
|
.SS Moving a mount
|
|
|
|
If
|
|
|
|
.I mountflags
|
|
|
|
contains the flag
|
2016-06-04 14:34:29 +00:00
|
|
|
.BR MS_MOVE
|
|
|
|
(available since Linux 2.4.18),
|
2016-06-04 13:44:46 +00:00
|
|
|
then move a subtree:
|
|
|
|
.I source
|
|
|
|
specifies an existing mount point and
|
|
|
|
.I target
|
|
|
|
specifies the new location to which that mount point is to be relocated.
|
|
|
|
The move is atomic: at no point is the subtree unmounted.
|
2016-06-04 14:11:50 +00:00
|
|
|
|
2016-06-04 13:44:46 +00:00
|
|
|
The remaining bits in the
|
|
|
|
.IR mountflags
|
|
|
|
argument are ignored, as are the
|
|
|
|
.IR filesystemtype
|
2006-04-25 08:18:18 +00:00
|
|
|
and
|
2016-06-04 13:44:46 +00:00
|
|
|
.IR data
|
|
|
|
arguments.
|
|
|
|
.\"
|
|
|
|
.SS Creating a new mount point
|
|
|
|
If none of
|
|
|
|
.BR MS_REMOUNT ,
|
|
|
|
.BR MS_BIND ,
|
|
|
|
.BR MS_MOVE ,
|
|
|
|
.BR MS_SHARED ,
|
|
|
|
.BR MS_PRIVATE ,
|
|
|
|
.BR MS_SLAVE ,
|
|
|
|
or
|
|
|
|
.BR MS_UNBINDABLE
|
|
|
|
is specified in
|
|
|
|
.IR mountflags ,
|
|
|
|
then
|
|
|
|
.BR mount ()
|
|
|
|
performs its default action: creating a new mount point.
|
|
|
|
.IR source
|
|
|
|
specifies the source for the new mount point, and
|
|
|
|
.IR target
|
|
|
|
specifies the directory at which to create the mount point.
|
|
|
|
|
2007-04-12 22:42:49 +00:00
|
|
|
The
|
2016-06-04 13:44:46 +00:00
|
|
|
.I filesystemtype
|
|
|
|
and
|
|
|
|
.I data
|
|
|
|
arguments are employed, and further bits may be specified in
|
|
|
|
.IR mountflags
|
|
|
|
to modify the behavior of the call.
|
|
|
|
.\"
|
iconv.1, localedef.1, access.2, execveat.2, fanotify_init.2, futex.2, ioctl_fat.2, mount.2, ftw.3, sd.4, tty_ioctl.4, fanotify.7, futex.7, posixoptions.7, iconvconfig.8: srcfix: Remove useless quotes from .SS and .SH sections
Signed-off-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-08 02:03:52 +00:00
|
|
|
.SH RETURN VALUE
|
2007-04-12 22:42:49 +00:00
|
|
|
On success, zero is returned.
|
|
|
|
On error, \-1 is returned, and
|
2004-11-03 13:51:07 +00:00
|
|
|
.I errno
|
|
|
|
is set appropriately.
|
|
|
|
.SH ERRORS
|
|
|
|
The error values given below result from filesystem type independent
|
2007-04-12 22:42:49 +00:00
|
|
|
errors.
|
intro.1, time.1, access.2, acct.2, alloc_hugepages.2, bind.2, chdir.2, chmod.2, chown.2, chroot.2, clone.2, close.2, execve.2, fallocate.2, fcntl.2, getdents.2, getrusage.2, getxattr.2, init_module.2, inotify_add_watch.2, ioprio_set.2, kcmp.2, link.2, listxattr.2, lseek.2, madvise.2, mkdir.2, mknod.2, mmap.2, mount.2, move_pages.2, msgctl.2, nfsservctl.2, open.2, pivot_root.2, quotactl.2, read.2, readlink.2, removexattr.2, rename.2, rmdir.2, semctl.2, setfsgid.2, setfsuid.2, setresuid.2, setuid.2, setup.2, setxattr.2, shmctl.2, splice.2, spu_create.2, stat.2, statfs.2, swapon.2, symlink.2, sync.2, sync_file_range.2, sysfs.2, truncate.2, umount.2, unlink.2, unshare.2, ustat.2, utime.2, utimensat.2, write.2, btree.3, errno.3, fexecve.3, ftw.3, futimes.3, get_nprocs_conf.3, getcwd.3, getdirentries.3, getmntent.3, glob.3, mkfifo.3, mq_open.3, readdir.3, realpath.3, recno.3, remove.3, sem_open.3, shm_open.3, statvfs.3, sysconf.3, telldir.3, tmpfile.3, cciss.4, initrd.4, pts.4, sk98lin.4, vcs.4, core.5, filesystems.5, proc.5, boot.7, bootparam.7, capabilities.7, cpuset.7, credentials.7, feature_test_macros.7, fifo.7, hier.7, inotify.7, intro.7, mq_overview.7, path_resolution.7, pipe.7, sem_overview.7, shm_overview.7, spufs.7, symlink.7, unix.7, uri.7, sync.8: Global fix: s/file system/filesystem/
Notwithstanding 24d01c530c5a3f75217543d02bf6712395e5f90c,
"filesystem" is the form used by the great majority of man pages
outside the man-pages project and in a number of other sources,
so let's go with that.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 08:07:57 +00:00
|
|
|
Each filesystem type may have its own special errors and its
|
2007-04-12 22:42:49 +00:00
|
|
|
own special behavior.
|
bdflush.2, get_robust_list.2, kexec_load.2, madvise.2, mmap.2, mount.2, prctl.2, query_module.2, rt_sigqueueinfo.2, shmget.2, sigaction.2, syscalls.2, umount.2, malloc.3, hpsa.4, initrd.4, proc.5, bootparam.7, icmp.7, netlink.7, signal.7: Global fix: use "Linux kernel source" consistently
Rather than "kernel source".
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-24 08:02:34 +00:00
|
|
|
See the Linux kernel source code for details.
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.B EACCES
|
2007-04-12 22:42:49 +00:00
|
|
|
A component of a path was not searchable.
|
|
|
|
(See also
|
2007-05-26 12:41:39 +00:00
|
|
|
.BR path_resolution (7).)
|
2016-06-04 15:46:36 +00:00
|
|
|
.TP
|
|
|
|
.B EACCES
|
|
|
|
Mounting a read-only filesystem was attempted without giving the
|
2007-04-12 22:42:49 +00:00
|
|
|
.B MS_RDONLY
|
2005-05-18 14:34:43 +00:00
|
|
|
flag.
|
2016-06-04 15:46:36 +00:00
|
|
|
.TP
|
|
|
|
.B EACCES
|
|
|
|
The block device
|
2004-11-03 13:51:07 +00:00
|
|
|
.I source
|
intro.1, time.1, access.2, acct.2, alloc_hugepages.2, bind.2, chdir.2, chmod.2, chown.2, chroot.2, clone.2, close.2, execve.2, fallocate.2, fcntl.2, getdents.2, getrusage.2, getxattr.2, init_module.2, inotify_add_watch.2, ioprio_set.2, kcmp.2, link.2, listxattr.2, lseek.2, madvise.2, mkdir.2, mknod.2, mmap.2, mount.2, move_pages.2, msgctl.2, nfsservctl.2, open.2, pivot_root.2, quotactl.2, read.2, readlink.2, removexattr.2, rename.2, rmdir.2, semctl.2, setfsgid.2, setfsuid.2, setresuid.2, setuid.2, setup.2, setxattr.2, shmctl.2, splice.2, spu_create.2, stat.2, statfs.2, swapon.2, symlink.2, sync.2, sync_file_range.2, sysfs.2, truncate.2, umount.2, unlink.2, unshare.2, ustat.2, utime.2, utimensat.2, write.2, btree.3, errno.3, fexecve.3, ftw.3, futimes.3, get_nprocs_conf.3, getcwd.3, getdirentries.3, getmntent.3, glob.3, mkfifo.3, mq_open.3, readdir.3, realpath.3, recno.3, remove.3, sem_open.3, shm_open.3, statvfs.3, sysconf.3, telldir.3, tmpfile.3, cciss.4, initrd.4, pts.4, sk98lin.4, vcs.4, core.5, filesystems.5, proc.5, boot.7, bootparam.7, capabilities.7, cpuset.7, credentials.7, feature_test_macros.7, fifo.7, hier.7, inotify.7, intro.7, mq_overview.7, path_resolution.7, pipe.7, sem_overview.7, shm_overview.7, spufs.7, symlink.7, unix.7, uri.7, sync.8: Global fix: s/file system/filesystem/
Notwithstanding 24d01c530c5a3f75217543d02bf6712395e5f90c,
"filesystem" is the form used by the great majority of man pages
outside the man-pages project and in a number of other sources,
so let's go with that.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 08:07:57 +00:00
|
|
|
is located on a filesystem mounted with the
|
2005-05-18 14:34:43 +00:00
|
|
|
.B MS_NODEV
|
|
|
|
option.
|
2004-11-03 13:51:07 +00:00
|
|
|
.\" mtk: Probably: write permission is required for MS_BIND, with
|
|
|
|
.\" the error EPERM if not present; CAP_DAC_OVERRIDE is required.
|
|
|
|
.TP
|
|
|
|
.B EBUSY
|
|
|
|
.I source
|
2007-04-12 22:42:49 +00:00
|
|
|
is already mounted.
|
2016-06-04 15:46:36 +00:00
|
|
|
.TP
|
|
|
|
.B EBUSY
|
|
|
|
.I source
|
|
|
|
cannot be remounted read-only,
|
2004-11-03 13:51:07 +00:00
|
|
|
because it still holds files open for writing.
|
2016-06-04 15:46:36 +00:00
|
|
|
.TP
|
|
|
|
.B EBUSY
|
|
|
|
.I source
|
|
|
|
cannot be mounted on
|
2004-11-03 13:51:07 +00:00
|
|
|
.I target
|
|
|
|
because
|
|
|
|
.I target
|
2011-10-03 13:40:42 +00:00
|
|
|
is still busy (it is the working directory of some thread,
|
2004-11-03 13:51:07 +00:00
|
|
|
the mount point of another device, has open files, etc.).
|
|
|
|
.TP
|
|
|
|
.B EFAULT
|
|
|
|
One of the pointer arguments points outside the user address space.
|
|
|
|
.TP
|
|
|
|
.B EINVAL
|
|
|
|
.I source
|
|
|
|
had an invalid superblock.
|
2016-06-04 15:46:36 +00:00
|
|
|
.TP
|
|
|
|
.B EINVAL
|
|
|
|
A remount operation
|
2005-05-18 14:34:43 +00:00
|
|
|
.RB ( MS_REMOUNT )
|
|
|
|
was attempted, but
|
2004-11-03 13:51:07 +00:00
|
|
|
.I source
|
|
|
|
was not already mounted on
|
|
|
|
.IR target .
|
2016-06-04 15:46:36 +00:00
|
|
|
.TP
|
|
|
|
.B EINVAL
|
|
|
|
A move operation
|
2005-05-18 14:34:43 +00:00
|
|
|
.RB ( MS_MOVE )
|
|
|
|
was attempted, but
|
2004-11-03 13:51:07 +00:00
|
|
|
.I source
|
2008-06-09 15:49:35 +00:00
|
|
|
was not a mount point, or was \(aq/\(aq.
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
2016-06-04 15:16:29 +00:00
|
|
|
.B EINVAL
|
|
|
|
.I mountflags
|
|
|
|
includes more than one of
|
|
|
|
.BR MS_SHARED ,
|
|
|
|
.BR MS_PRIVATE ,
|
|
|
|
.BR MS_SLAVE ,
|
|
|
|
or
|
|
|
|
.BR MS_UNBINDABLE .
|
|
|
|
.TP
|
|
|
|
.B EINVAL
|
|
|
|
.I mountflags
|
|
|
|
includes
|
|
|
|
.BR MS_SHARED ,
|
|
|
|
.BR MS_PRIVATE ,
|
|
|
|
.BR MS_SLAVE ,
|
|
|
|
or
|
|
|
|
.BR MS_UNBINDABLE
|
|
|
|
and also includes a flag other than
|
|
|
|
.BR MS_REC
|
|
|
|
or
|
|
|
|
.BR MS_SILENT .
|
|
|
|
.TP
|
|
|
|
.BR EINVAL
|
|
|
|
An attempt was made to bind mount an unbindable mount.
|
|
|
|
.TP
|
2004-11-03 13:51:07 +00:00
|
|
|
.B ELOOP
|
2008-10-06 09:49:27 +00:00
|
|
|
Too many links encountered during pathname resolution.
|
2016-06-04 15:46:36 +00:00
|
|
|
.TP
|
|
|
|
.B ELOOP
|
|
|
|
A move operation was attempted, and
|
2004-11-03 13:51:07 +00:00
|
|
|
.I target
|
|
|
|
is a descendant of
|
|
|
|
.IR source .
|
|
|
|
.TP
|
|
|
|
.B EMFILE
|
|
|
|
(In case no block device is required:)
|
|
|
|
Table of dummy devices is full.
|
|
|
|
.TP
|
|
|
|
.B ENAMETOOLONG
|
2007-06-22 17:16:20 +00:00
|
|
|
A pathname was longer than
|
|
|
|
.BR MAXPATHLEN .
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.B ENODEV
|
2006-06-08 17:59:39 +00:00
|
|
|
.I filesystemtype
|
2004-11-03 13:51:07 +00:00
|
|
|
not configured in the kernel.
|
|
|
|
.TP
|
|
|
|
.B ENOENT
|
|
|
|
A pathname was empty or had a nonexistent component.
|
|
|
|
.TP
|
|
|
|
.B ENOMEM
|
|
|
|
The kernel could not allocate a free page to copy filenames or data into.
|
|
|
|
.TP
|
|
|
|
.B ENOTBLK
|
|
|
|
.I source
|
|
|
|
is not a block device (and a device was required).
|
|
|
|
.TP
|
|
|
|
.B ENOTDIR
|
2008-10-06 11:09:26 +00:00
|
|
|
.IR target ,
|
|
|
|
or a prefix of
|
|
|
|
.IR source ,
|
|
|
|
is not a directory.
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.B ENXIO
|
|
|
|
The major number of the block device
|
|
|
|
.I source
|
|
|
|
is out of range.
|
|
|
|
.TP
|
|
|
|
.B EPERM
|
|
|
|
The caller does not have the required privileges.
|
2010-09-10 06:09:14 +00:00
|
|
|
.SH VERSIONS
|
|
|
|
The definitions of
|
|
|
|
.BR MS_DIRSYNC ,
|
|
|
|
.BR MS_MOVE ,
|
2016-06-04 13:44:46 +00:00
|
|
|
.BR MS_PRIVATE ,
|
2010-09-10 06:09:14 +00:00
|
|
|
.BR MS_REC ,
|
|
|
|
.BR MS_RELATIME ,
|
2016-06-04 13:44:46 +00:00
|
|
|
.BR MS_SHARED ,
|
|
|
|
.BR MS_SLAVED ,
|
2010-09-10 06:09:14 +00:00
|
|
|
.BR MS_STRICTATIME
|
2016-06-04 13:44:46 +00:00
|
|
|
and
|
|
|
|
.BR MS_UNBINDABLE
|
intro.1, _syscall.2, access.2, arch_prctl.2, cacheflush.2, chown.2, clock_getres.2, clone.2, create_module.2, fcntl.2, flock.2, get_kernel_syms.2, get_robust_list.2, get_thread_area.2, getcpu.2, getpriority.2, getrlimit.2, getrusage.2, ioprio_set.2, kexec_load.2, madvise.2, mbind.2, migrate_pages.2, mknod.2, mmap.2, mount.2, move_pages.2, mprotect.2, open.2, pause.2, pciconfig_read.2, perf_event_open.2, prctl.2, ptrace.2, query_module.2, read.2, reboot.2, recv.2, s390_runtime_instr.2, sched_setscheduler.2, select_tut.2, send.2, set_mempolicy.2, setfsgid.2, setfsuid.2, sigaction.2, spu_create.2, spu_run.2, stime.2, swapon.2, syslog.2, timer_create.2, timer_getoverrun.2, times.2, tkill.2, umount.2, unimplemented.2, ustat.2, vm86.2, wait.2, abs.3, aio_read.3, aio_write.3, bsd_signal.3, catgets.3, clearenv.3, cmsg.3, dbopen.3, dirfd.3, dlopen.3, exec.3, fenv.3, ferror.3, fmemopen.3, fnmatch.3, fopen.3, futimes.3, getaddrinfo.3, getifaddrs.3, getipnodebyname.3, hsearch.3, if_nameindex.3, inet_pton.3, mblen.3, mbrlen.3, mbsrtowcs.3, mbtowc.3, mcheck.3, memfrob.3, mq_notify.3, netlink.3, posix_memalign.3, printf.3, pthread_attr_setscope.3, pthread_cleanup_push.3, pthread_kill_other_threads_np.3, pthread_self.3, pthread_setcancelstate.3, pthread_setconcurrency.3, raise.3, resolver.3, rpc.3, rtime.3, rtnetlink.3, scanf.3, setbuf.3, setnetgrent.3, shm_open.3, sigpause.3, sigset.3, sigwait.3, sockatmark.3, strcasecmp.3, strcmp.3, strdup.3, strftime.3, strptime.3, strsignal.3, strverscmp.3, sysv_signal.3, termios.3, wcrtomb.3, wcsnlen.3, wcsnrtombs.3, wcsrtombs.3, wctomb.3, wprintf.3, console_codes.4, cpuid.4, msr.4, rtc.4, sk98lin.4, st.4, tty.4, charmap.5, core.5, elf.5, hosts.equiv.5, proc.5, resolv.conf.5, services.5, slabinfo.5, arp.7, bootparam.7, capabilities.7, charsets.7, cpuset.7, ddp.7, epoll.7, feature_test_macros.7, futex.7, hier.7, icmp.7, inotify.7, ip.7, ipv6.7, man-pages.7, mdoc.7, mdoc.samples.7, netdevice.7, netlink.7, numa.7, packet.7, path_resolution.7, posixoptions.7, pthreads.7, raw.7, rtld-audit.7, rtnetlink.7, sem_overview.7, sigevent.7, socket.7, spufs.7, tcp.7, udp.7, unicode.7, uri.7, utf-8.7, intro.8, ldconfig.8, sync.8: Global fix: fix placement of word "only"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-03-31 08:53:00 +00:00
|
|
|
were added to glibc headers in version 2.12.
|
2016-06-04 13:44:46 +00:00
|
|
|
.\"
|
iconv.1, localedef.1, access.2, execveat.2, fanotify_init.2, futex.2, ioctl_fat.2, mount.2, ftw.3, sd.4, tty_ioctl.4, fanotify.7, futex.7, posixoptions.7, iconvconfig.8: srcfix: Remove useless quotes from .SS and .SH sections
Signed-off-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-08 02:03:52 +00:00
|
|
|
.SH CONFORMING TO
|
2008-10-06 11:09:26 +00:00
|
|
|
This function is Linux-specific and should not be used in
|
2004-11-03 13:51:07 +00:00
|
|
|
programs intended to be portable.
|
2007-05-18 11:59:14 +00:00
|
|
|
.SH NOTES
|
2016-06-04 12:28:06 +00:00
|
|
|
Since Linux 2.4 a single filesystem can be mounted at
|
|
|
|
multiple mount points, and multiple mounts can be stacked
|
|
|
|
on the same mount point.
|
|
|
|
.\" Multiple mounts on same mount point: since 2.3.99pre7.
|
|
|
|
|
2016-06-04 11:54:01 +00:00
|
|
|
The
|
|
|
|
.I mountflags
|
|
|
|
argument may have the magic number 0xC0ED (\fBMS_MGC_VAL\fP)
|
|
|
|
in the top 16 bits.
|
|
|
|
(All of the other flags discussed in DESCRIPTION
|
|
|
|
occupy the low order 16 bits of
|
|
|
|
.IR mountflags .)
|
|
|
|
Specifying
|
|
|
|
.BR MS_MGC_VAL
|
|
|
|
was required in kernel versions prior to 2.4,
|
|
|
|
but since Linux 2.4 is no longer required and is ignored if specified.
|
|
|
|
|
2004-11-03 13:51:07 +00:00
|
|
|
The original
|
2007-09-20 16:26:31 +00:00
|
|
|
.B MS_SYNC
|
2007-06-22 17:16:20 +00:00
|
|
|
flag was renamed
|
2007-09-20 16:26:31 +00:00
|
|
|
.B MS_SYNCHRONOUS
|
2007-06-22 17:16:20 +00:00
|
|
|
in 1.1.69
|
|
|
|
when a different
|
2007-09-20 16:26:31 +00:00
|
|
|
.B MS_SYNC
|
2007-06-22 17:16:20 +00:00
|
|
|
was added to \fI<mman.h>\fP.
|
2004-11-03 13:51:07 +00:00
|
|
|
.LP
|
2005-07-18 14:25:42 +00:00
|
|
|
Before Linux 2.4 an attempt to execute a set-user-ID or set-group-ID program
|
intro.1, time.1, access.2, acct.2, alloc_hugepages.2, bind.2, chdir.2, chmod.2, chown.2, chroot.2, clone.2, close.2, execve.2, fallocate.2, fcntl.2, getdents.2, getrusage.2, getxattr.2, init_module.2, inotify_add_watch.2, ioprio_set.2, kcmp.2, link.2, listxattr.2, lseek.2, madvise.2, mkdir.2, mknod.2, mmap.2, mount.2, move_pages.2, msgctl.2, nfsservctl.2, open.2, pivot_root.2, quotactl.2, read.2, readlink.2, removexattr.2, rename.2, rmdir.2, semctl.2, setfsgid.2, setfsuid.2, setresuid.2, setuid.2, setup.2, setxattr.2, shmctl.2, splice.2, spu_create.2, stat.2, statfs.2, swapon.2, symlink.2, sync.2, sync_file_range.2, sysfs.2, truncate.2, umount.2, unlink.2, unshare.2, ustat.2, utime.2, utimensat.2, write.2, btree.3, errno.3, fexecve.3, ftw.3, futimes.3, get_nprocs_conf.3, getcwd.3, getdirentries.3, getmntent.3, glob.3, mkfifo.3, mq_open.3, readdir.3, realpath.3, recno.3, remove.3, sem_open.3, shm_open.3, statvfs.3, sysconf.3, telldir.3, tmpfile.3, cciss.4, initrd.4, pts.4, sk98lin.4, vcs.4, core.5, filesystems.5, proc.5, boot.7, bootparam.7, capabilities.7, cpuset.7, credentials.7, feature_test_macros.7, fifo.7, hier.7, inotify.7, intro.7, mq_overview.7, path_resolution.7, pipe.7, sem_overview.7, shm_overview.7, spufs.7, symlink.7, unix.7, uri.7, sync.8: Global fix: s/file system/filesystem/
Notwithstanding 24d01c530c5a3f75217543d02bf6712395e5f90c,
"filesystem" is the form used by the great majority of man pages
outside the man-pages project and in a number of other sources,
so let's go with that.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 08:07:57 +00:00
|
|
|
on a filesystem mounted with
|
2004-11-03 13:51:07 +00:00
|
|
|
.B MS_NOSUID
|
|
|
|
would fail with
|
|
|
|
.BR EPERM .
|
2007-04-12 22:42:49 +00:00
|
|
|
Since Linux 2.4 the set-user-ID and set-group-ID bits are
|
2005-07-18 14:25:42 +00:00
|
|
|
just silently ignored in this case.
|
2004-11-03 13:51:07 +00:00
|
|
|
.\" The change is in patch-2.4.0-prerelease.
|
2016-06-04 12:28:06 +00:00
|
|
|
.\"
|
|
|
|
|
2013-03-10 12:05:00 +00:00
|
|
|
.SS Per-process namespaces
|
2008-11-19 19:23:47 +00:00
|
|
|
Starting with kernel 2.4.19, Linux provides
|
2008-11-20 16:04:07 +00:00
|
|
|
per-process mount namespaces.
|
intro.1, time.1, access.2, acct.2, alloc_hugepages.2, bind.2, chdir.2, chmod.2, chown.2, chroot.2, clone.2, close.2, execve.2, fallocate.2, fcntl.2, getdents.2, getrusage.2, getxattr.2, init_module.2, inotify_add_watch.2, ioprio_set.2, kcmp.2, link.2, listxattr.2, lseek.2, madvise.2, mkdir.2, mknod.2, mmap.2, mount.2, move_pages.2, msgctl.2, nfsservctl.2, open.2, pivot_root.2, quotactl.2, read.2, readlink.2, removexattr.2, rename.2, rmdir.2, semctl.2, setfsgid.2, setfsuid.2, setresuid.2, setuid.2, setup.2, setxattr.2, shmctl.2, splice.2, spu_create.2, stat.2, statfs.2, swapon.2, symlink.2, sync.2, sync_file_range.2, sysfs.2, truncate.2, umount.2, unlink.2, unshare.2, ustat.2, utime.2, utimensat.2, write.2, btree.3, errno.3, fexecve.3, ftw.3, futimes.3, get_nprocs_conf.3, getcwd.3, getdirentries.3, getmntent.3, glob.3, mkfifo.3, mq_open.3, readdir.3, realpath.3, recno.3, remove.3, sem_open.3, shm_open.3, statvfs.3, sysconf.3, telldir.3, tmpfile.3, cciss.4, initrd.4, pts.4, sk98lin.4, vcs.4, core.5, filesystems.5, proc.5, boot.7, bootparam.7, capabilities.7, cpuset.7, credentials.7, feature_test_macros.7, fifo.7, hier.7, inotify.7, intro.7, mq_overview.7, path_resolution.7, pipe.7, sem_overview.7, shm_overview.7, spufs.7, symlink.7, unix.7, uri.7, sync.8: Global fix: s/file system/filesystem/
Notwithstanding 24d01c530c5a3f75217543d02bf6712395e5f90c,
"filesystem" is the form used by the great majority of man pages
outside the man-pages project and in a number of other sources,
so let's go with that.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 08:07:57 +00:00
|
|
|
A mount namespace is the set of filesystem mounts that
|
2008-11-19 19:23:47 +00:00
|
|
|
are visible to a process.
|
|
|
|
Mount-point namespaces can be (and usually are)
|
|
|
|
shared between multiple processes,
|
2008-10-06 12:07:03 +00:00
|
|
|
and changes to the namespace (i.e., mounts and unmounts) by one process
|
|
|
|
are visible to all other processes sharing the same namespace.
|
2009-09-27 07:26:29 +00:00
|
|
|
(The pre-2.4.19 Linux situation can be considered as one in which
|
|
|
|
a single namespace was shared by every process on the system.)
|
2008-10-06 12:07:03 +00:00
|
|
|
|
|
|
|
A child process created by
|
|
|
|
.BR fork (2)
|
2008-11-20 16:04:07 +00:00
|
|
|
shares its parent's mount namespace;
|
|
|
|
the mount namespace is preserved across an
|
2008-10-06 12:07:03 +00:00
|
|
|
.BR execve (2).
|
|
|
|
|
2008-11-20 16:04:07 +00:00
|
|
|
A process can obtain a private mount namespace if:
|
2008-10-06 12:07:03 +00:00
|
|
|
it was created using the
|
Changes, clone.2, mount.2, nanosleep.2, sigaltstack.2, statfs.2, timer_settime.2, ctime.3, fmemopen.3, nl_langinfo.3, posix_memalign.3, pthread_attr_init.3, pthread_setaffinity_np.3, pthread_setschedprio.3, pthread_testcancel.3, setjmp.3, sigwait.3, tty_ioctl.4, epoll.7, posixoptions.7, unix.7: Add section number to references to functions documented in other pages
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-01 07:07:28 +00:00
|
|
|
.BR clone (2)
|
2008-10-06 12:07:03 +00:00
|
|
|
.BR CLONE_NEWNS
|
|
|
|
flag,
|
|
|
|
in which case its new namespace is initialized to be a
|
|
|
|
.I copy
|
|
|
|
of the namespace of the process that called
|
Changes, clone.2, mount.2, nanosleep.2, sigaltstack.2, statfs.2, timer_settime.2, ctime.3, fmemopen.3, nl_langinfo.3, posix_memalign.3, pthread_attr_init.3, pthread_setaffinity_np.3, pthread_setschedprio.3, pthread_testcancel.3, setjmp.3, sigwait.3, tty_ioctl.4, epoll.7, posixoptions.7, unix.7: Add section number to references to functions documented in other pages
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-01 07:07:28 +00:00
|
|
|
.BR clone (2);
|
2008-10-06 12:07:03 +00:00
|
|
|
or it calls
|
|
|
|
.BR unshare (2)
|
2008-10-07 08:58:44 +00:00
|
|
|
with the
|
2008-10-06 12:07:03 +00:00
|
|
|
.BR CLONE_NEWNS
|
|
|
|
flag,
|
2008-11-20 16:04:07 +00:00
|
|
|
which causes the caller's mount namespace to obtain a private copy
|
2008-10-06 12:07:03 +00:00
|
|
|
of the namespace that it was previously sharing with other processes,
|
|
|
|
so that future mounts and unmounts by the caller are invisible
|
|
|
|
to other processes (except child processes that the caller
|
|
|
|
subsequently creates) and vice versa.
|
|
|
|
|
|
|
|
The Linux-specific
|
2010-05-22 03:32:46 +00:00
|
|
|
.I /proc/PID/mounts
|
2008-11-20 16:04:07 +00:00
|
|
|
file exposes the list of mount points in the mount
|
2008-11-19 19:23:47 +00:00
|
|
|
namespace of the process with the specified ID; see
|
2008-10-06 12:07:03 +00:00
|
|
|
.BR proc (5)
|
|
|
|
for details.
|
iconv.1, localedef.1, access.2, execveat.2, fanotify_init.2, futex.2, ioctl_fat.2, mount.2, ftw.3, sd.4, tty_ioctl.4, fanotify.7, futex.7, posixoptions.7, iconvconfig.8: srcfix: Remove useless quotes from .SS and .SH sections
Signed-off-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-08 02:03:52 +00:00
|
|
|
.SH SEE ALSO
|
2008-10-06 11:09:26 +00:00
|
|
|
.BR umount (2),
|
2016-06-18 20:11:41 +00:00
|
|
|
.BR mount_namespaces (7),
|
2007-05-26 12:41:39 +00:00
|
|
|
.BR path_resolution (7),
|
2014-10-03 06:41:54 +00:00
|
|
|
.BR lsblk (8),
|
2016-02-15 12:45:27 +00:00
|
|
|
.BR findmnt (8),
|
2004-11-03 13:51:07 +00:00
|
|
|
.BR mount (8),
|
|
|
|
.BR umount (8)
|