Skip to content

Commit 3e817a4

Browse files
committed
Hard link limitations in union filesystems
Signed-off-by: Brandon Mitchell <git@bmitch.net>
1 parent da92727 commit 3e817a4

File tree

1 file changed

+2
-0
lines changed

1 file changed

+2
-0
lines changed

layer.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -69,6 +69,8 @@ Where supported, MUST include file attributes for Additions and Modifications in
6969
- Non-directory files are considered "hardlinked" when their link count is greater than 1.
7070
- Hardlinked files are on a same device (i.e. comparing Major:Minor pair) and have the same inode.
7171
- The corresponding files that share the link with the > 1 linkcount may be outside the directory that the changeset is being produced from, in which case the `linkname` is not recorded in the changeset.
72+
- Union filesystem implementations may have limited or no support for hardlinks, particularly when a change is made to a hardlinked file or a hardlink is created to a file in a lower filesystem.
73+
- Extracting a layer with hardlink references to files outside of the layer may fail.
7274
- Hardlinks are stored in a tar archive with type of a `1` char, per the [GNU Basic Tar Format][gnu-tar-standard] and [libarchive tar(5)][libarchive-tar].
7375
- While approaches to deriving new or changed hardlinks may vary, a possible approach is:
7476

0 commit comments

Comments
 (0)