From 08c2540cb7649b8f9eea8435551e5dc3bc11a250 Mon Sep 17 00:00:00 2001 From: David Oberhollenzer Date: Sat, 19 Nov 2022 16:59:41 +0100 Subject: Add a man-page section about the xattr file format Signed-off-by: David Oberhollenzer --- bin/gensquashfs/gensquashfs.1 | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) (limited to 'bin/gensquashfs/gensquashfs.1') diff --git a/bin/gensquashfs/gensquashfs.1 b/bin/gensquashfs/gensquashfs.1 index f0697ab..88f58c4 100644 --- a/bin/gensquashfs/gensquashfs.1 +++ b/bin/gensquashfs/gensquashfs.1 @@ -95,6 +95,10 @@ A short hand for `\-\-set\-uid 0 \-\-set\-gid 0`. If built with SELinux support, use the given SELinux label file to add context labels to the elements packed into the SquashFS image. .TP +\fB\-\-xattr-file\fR, \fB\-A\fR +Read extended attributes from a file. The format for the file is identical to +the output generated by `\fBgetfattr \-\-dump\fR`. +.TP \fB\-\-exportable\fR, \fB\-e\fR Generate an export table for NFS support. .TP @@ -345,6 +349,33 @@ T} # For demonstration, a quoted filename and no flags 1337 "usr/share/my \\"special\\" file " .fi +.SH XATTR FILE FORMAT +The format for xattr files tries to be identical to the output +of \fBgetfattr\fR. + +Attributes are listed as key-value pairs with an \fB=\fR sign in between. + +If a line starts with `\fB# file: \fR`, the rest of the line is interpreted +as an absolute path that the following xattrs are applied to. + +Plain text values are wrapped in quotation marks ("...") and support some +escape sequences. +Currently supported are \fB\\"\fR, \fB\\\\\fR and \fB\\0\fR. + +Raw binary values can encoded as hexadecimal or base64, by starting the +value with a \fB0x\fR or \fB0s\fR prefix respectively. + +.SS Example +.PP +.nf +# file: dev/ +security.selinux="system_u:object_r:device_t:s0" +user.beverage_preference=0xCAFECAFEDECAFBAD + +# file: dev/rfkill +security.selinux="system_u:object_r:wireless_device_t:s0" +system.posix_acl_access=0sSGVsbG8gdGhlcmUgOi0pCg== +.fi .SH ENVIRONMENT If the command line switch \fB\-\-defaults\fR is not used or no default mtime is specified, the value of the environment variable \fBSOURCE\_DATE\_EPOCH\fR -- cgit v1.2.3