tmpfs.5: Document current mount options

Some of this content is moved from the mount(8) man page.
Style was based on proc(5) sections.

Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Carsten Grohmann 2018-01-27 04:59:28 -05:00 committed by Michael Kerrisk
parent 724127aa2d
commit 462a385e9a
1 changed files with 73 additions and 4 deletions

View File

@ -51,10 +51,6 @@ filesystem has the following properties:
The filesystem can employ swap space when physical memory pressure
demands it.
.IP *
The
.I size
option can be used to specify an upper limit on the size of the filesystem.
(The default size is half of the available RAM size.)
The filesystem consumes only as much physical memory and swap space
as is required to store the current contents of the filesystem.
.IP *
@ -66,6 +62,79 @@ the filesystem size can be changed
If a
.B tmpfs
filesystem is unmounted, its contents are discarded (lost).
.\" See mm/shmem.c:shmem_parse_options for options it supports.
.SS Mount options
The
.B tmpfs
filesystem supports the following mount options:
.TP
.BR size "=\fIbytes\fP"
Specify an upper limit on the size of the filesystem.
The size is given in bytes, and rounded up to entire pages.
The size may have a
.BR k ,
.BR m ,
or
.B g
suffix for Ki, Mi, Gi (binary kilo (kibi), binary mega (mebi) and binary giga
(gibi)).
The size may also have a % suffix to limit this instance to a percentage of
physical RAM.
The default, when neither size nor nr_blocks is specified, is size=50%.
.TP
.BR nr_blocks "=\fIblocks\fP"
The same as
.BR size ,
but in blocks of PAGE_CACHE_SIZE.
Blocks may be specified with
.BR k ,
.BR m ,
or
.B g
suffixes like
.BR size ,
but not a % suffix.
.TP
.BR nr_inodes "=\fIinodes\fP"
The maximum number of inodes for this instance.
The default is half of the number of your physical RAM pages, or (on a
machine with highmem) the number of lowmem RAM pages, whichever is smaller.
Inodes may be specified with
.BR k ,
.BR m ,
or
.B g
suffixes like
.BR size ,
but not a % suffix.
.TP
.BR mode "=\fImode\fP"
Set initial permissions of the root directory.
.TP
.BR gid "=\fIgid\fP (since Linux 2.5.7)"
.\" Technically this is also in some version of Linux 2.4.
.\" commit 099445b489625b80b1d6687c9b6072dbeaca4096
Set the initial group ID of the root directory.
.TP
.BR uid "=\fIuid\fP (since Linux 2.5.7)"
.\" Technically this is also in some version of Linux 2.4.
.\" commit 099445b489625b80b1d6687c9b6072dbeaca4096
Set the initial user ID of the root directory.
.TP
.BR huge "=\fI[never|always|within_size|advise|deny|force]\fR (since Linux 4.7.0)"
.\" commit 5a6e75f8110c97e2a5488894d4e922187e6cb343
Set the huge table memory allocation policy for all files in this instance (if
CONFIG_TRANSPARENT_HUGE_PAGECACHE is enabled).
.TP
.BR mpol "=\fI[default|prefer:Node|bind:NodeList|interleave|interleave:NodeList]\fR (since Linux 2.6.15)"
.\" commit 7339ff8302fd70aabf5f1ae26e0c4905fa74a495
Set the NUMA memory allocation policy for all files in this instance (if
CONFIG_NUMA is enabled).
.SH VERSIONS
The
.B tmpfs