@@ -9,7 +9,7 @@ Overlay Filesystem
99This document describes a prototype for a new approach to providing
1010overlay-filesystem functionality in Linux (sometimes referred to as
1111union-filesystems). An overlay-filesystem tries to present a
12- filesystem which is the result over overlaying one filesystem on top
12+ filesystem which is the result of overlaying one filesystem on top
1313of the other.
1414
1515
@@ -425,7 +425,7 @@ of information from up to three different layers:
425425The "lower data" file can be on any lower layer, except from the top most
426426lower layer.
427427
428- Below the top most lower layer, any number of lower most layers may be defined
428+ Below the topmost lower layer, any number of lowermost layers may be defined
429429as "data-only" lower layers, using double colon ("::") separators.
430430A normal lower layer is not allowed to be below a data-only layer, so single
431431colon separators are not allowed to the right of double colon ("::") separators.
@@ -445,8 +445,8 @@ to the absolute path of the "lower data" file in the "data-only" lower layer.
445445
446446Instead of explicitly enabling "metacopy=on" it is sufficient to specify at
447447least one data-only layer to enable redirection of data to a data-only layer.
448- In this case other forms of metacopy are rejected. Note: this way data-only
449- layers may be used toghether with "userxattr", in which case careful attention
448+ In this case other forms of metacopy are rejected. Note: this way, data-only
449+ layers may be used together with "userxattr", in which case careful attention
450450must be given to privileges needed to change the "user.overlay.redirect" xattr
451451to prevent misuse.
452452
@@ -515,7 +515,7 @@ supports these values:
515515 The metacopy digest is never generated or used. This is the
516516 default if verity option is not specified.
517517- "on":
518- Whenever a metacopy files specifies an expected digest, the
518+ Whenever a metacopy file specifies an expected digest, the
519519 corresponding data file must match the specified digest. When
520520 generating a metacopy file the verity digest will be set in it
521521 based on the source file (if it has one).
@@ -537,7 +537,7 @@ Using an upper layer path and/or a workdir path that are already used by
537537another overlay mount is not allowed and may fail with EBUSY. Using
538538partially overlapping paths is not allowed and may fail with EBUSY.
539539If files are accessed from two overlayfs mounts which share or overlap the
540- upper layer and/or workdir path the behavior of the overlay is undefined,
540+ upper layer and/or workdir path, the behavior of the overlay is undefined,
541541though it will not result in a crash or deadlock.
542542
543543Mounting an overlay using an upper layer path, where the upper layer path
@@ -778,7 +778,7 @@ controlled by the "uuid" mount option, which supports these values:
778778- "auto": (default)
779779 UUID is taken from xattr "trusted.overlay.uuid" if it exists.
780780 Upgrade to "uuid=on" on first time mount of new overlay filesystem that
781- meets the prerequites .
781+ meets the prerequisites .
782782 Downgrade to "uuid=null" for existing overlay filesystems that were never
783783 mounted with "uuid=on".
784784
@@ -794,20 +794,20 @@ without significant effort.
794794The advantage of mounting with the "volatile" option is that all forms of
795795sync calls to the upper filesystem are omitted.
796796
797- In order to avoid a giving a false sense of safety, the syncfs (and fsync)
797+ In order to avoid giving a false sense of safety, the syncfs (and fsync)
798798semantics of volatile mounts are slightly different than that of the rest of
799799VFS. If any writeback error occurs on the upperdir's filesystem after a
800800volatile mount takes place, all sync functions will return an error. Once this
801801condition is reached, the filesystem will not recover, and every subsequent sync
802- call will return an error, even if the upperdir has not experience a new error
802+ call will return an error, even if the upperdir has not experienced a new error
803803since the last sync call.
804804
805805When overlay is mounted with "volatile" option, the directory
806806"$workdir/work/incompat/volatile" is created. During next mount, overlay
807807checks for this directory and refuses to mount if present. This is a strong
808- indicator that user should throw away upper and work directories and create
809- fresh one . In very limited cases where the user knows that the system has
810- not crashed and contents of upperdir are intact, The "volatile" directory
808+ indicator that the user should discard upper and work directories and create
809+ fresh ones . In very limited cases where the user knows that the system has
810+ not crashed and contents of upperdir are intact, the "volatile" directory
811811can be removed.
812812
813813
0 commit comments