LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

rename.2: Some additional notes regarding RENAME_WHITEOUT 

Add a note regarding other implementations of whiteout inodes
and update filesystem support information.

Signed-off-by: Eugene Syromiatnikov <esyr@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Eugene Syromiatnikov 2019-01-04 16:35:45 +01:00 committed by Michael Kerrisk
parent b0f5ce2757
commit 5fc33f3827
1 changed files with 15 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
man2/rename.2
View File

@ -267,6 +267,14 @@ The whole operation needs to be done atomically.
.IP
When not part of a union/overlay,
the whiteout appears as a character device with a {0,0} device number.
.\" https://www.freebsd.org/cgi/man.cgi?query=mount_unionfs&manpath=FreeBSD+11.0-RELEASE
(Note that other union/overlay implementations may employ different methods
for storing whiteout entries; specifically, BSD union mount employs
a separate inode type,
.BR DT_WHT ,
which, while supported by some file systems available in Linux,
such as CODA and XFS, is ignored by the kernel's whiteout support code,
as of Linux 4.19, at least.)
.IP
.B RENAME_WHITEOUT
requires the same privileges as creating a device node (i.e., the
@ -284,8 +292,14 @@ tmpfs (since Linux 3.18),
.\" tmpfs: commit 46fdb794e3f52ef18b859ebc92f0a9d7db21c5df
ext4 (since Linux 3.18),
.\" ext4: commit cd808deced431b66b5fa4e5c193cb7ec0059eaff
and XFS (since Linux 4.1).
XFS (since Linux 4.1),
.\" XFS: commit 7dcf5c3e4527cfa2807567b00387cf2ed5e07f00
f2fs (since Linux 4.2).
.\" f2fs: commit 7e01e7ad746bc8198a8b46163ddc73a1c7d22339
btrfs (since Linux 4.7),
.\" btrfs: commit cdd1fedf8261cd7a73c0596298902ff4f0f04492
and ubifs (since Linux 4.9).
.\" ubifs: commit 9e0a1fff8db56eaaebb74b4a3ef65f86811c4798
.SH RETURN VALUE
On success, zero is returned.
On error, \-1 is returned, and