]> git.ipfire.org Git - thirdparty/xfsprogs-dev.git/commitdiff
xfs_io: implement 'set_encpolicy' and 'get_encpolicy' commands
authorEric Biggers <ebiggers@google.com>
Thu, 12 Jan 2017 20:12:40 +0000 (14:12 -0600)
committerEric Sandeen <sandeen@redhat.com>
Thu, 12 Jan 2017 20:12:40 +0000 (14:12 -0600)
Add set_encpolicy and get_encpolicy commands to xfs_io so that xfstests
will be able to test filesystem encryption using the actual user API,
not just hacked in with a mount option.  These commands use the common
"fscrypt" API currently implemented by ext4 and f2fs, but it's also
under development for ubifs and planned for xfs.

Note that to get encrypted files to actually work, it's also necessary
to add a key to the kernel keyring.  This patch does not add a command
for this to xfs_io because it's possible to do it using keyctl.  keyctl
can also be used to remove keys, revoke keys, invalidate keys, etc.

Signed-off-by: Eric Biggers <ebiggers@google.com>
Reviewed-by: Eric Sandeen <sandeen@redhat.com>
Signed-off-by: Eric Sandeen <sandeen@sandeen.net>
io/Makefile
io/encrypt.c [new file with mode: 0644]
io/init.c
io/io.h
man/man8/xfs_io.8

index 1072e748e20bb701415550c16b7004b4d917c99e..89cca661798eeda52727fab721563d237242a6f4 100644 (file)
@@ -9,9 +9,9 @@ LTCOMMAND = xfs_io
 LSRCFILES = xfs_bmap.sh xfs_freeze.sh xfs_mkfile.sh
 HFILES = init.h io.h
 CFILES = init.c \
-       attr.c bmap.c file.c freeze.c fsync.c getrusage.c imap.c link.c \
-       mmap.c open.c parent.c pread.c prealloc.c pwrite.c seek.c shutdown.c \
-       sync.c truncate.c reflink.c cowextsize.c
+       attr.c bmap.c encrypt.c file.c freeze.c fsync.c getrusage.c imap.c   \
+       link.c mmap.c open.c parent.c pread.c prealloc.c pwrite.c seek.c     \
+       shutdown.c sync.c truncate.c reflink.c cowextsize.c
 
 LLDLIBS = $(LIBXCMD) $(LIBHANDLE) $(LIBPTHREAD)
 LTDEPENDENCIES = $(LIBXCMD) $(LIBHANDLE)
diff --git a/io/encrypt.c b/io/encrypt.c
new file mode 100644 (file)
index 0000000..d844c5e
--- /dev/null
@@ -0,0 +1,302 @@
+/*
+ * Copyright (c) 2016 Google, Inc.  All Rights Reserved.
+ *
+ * Author: Eric Biggers <ebiggers@google.com>
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License as
+ * published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it would be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write the Free Software Foundation,
+ * Inc.,  51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+ */
+
+#include "platform_defs.h"
+#include "command.h"
+#include "init.h"
+#include "io.h"
+
+#ifndef ARRAY_SIZE
+#define ARRAY_SIZE(x) (sizeof(x) / sizeof((x)[0]))
+#endif
+
+/*
+ * We may have to declare the fscrypt ioctls ourselves because someone may be
+ * compiling xfsprogs with old kernel headers.  And since some old versions of
+ * <linux/fs.h> declared the policy struct and ioctl numbers but not the flags
+ * and modes, our declarations must be split into two conditional blocks.
+ */
+
+/* Policy struct and ioctl numbers */
+#ifndef FS_IOC_SET_ENCRYPTION_POLICY
+#define FS_KEY_DESCRIPTOR_SIZE  8
+
+struct fscrypt_policy {
+       __u8 version;
+       __u8 contents_encryption_mode;
+       __u8 filenames_encryption_mode;
+       __u8 flags;
+       __u8 master_key_descriptor[FS_KEY_DESCRIPTOR_SIZE];
+} __attribute__((packed));
+
+#define FS_IOC_SET_ENCRYPTION_POLICY   _IOR('f', 19, struct fscrypt_policy)
+#define FS_IOC_GET_ENCRYPTION_PWSALT   _IOW('f', 20, __u8[16])
+#define FS_IOC_GET_ENCRYPTION_POLICY   _IOW('f', 21, struct fscrypt_policy)
+#endif /* FS_IOC_SET_ENCRYPTION_POLICY */
+
+/* Policy flags and encryption modes */
+#ifndef FS_ENCRYPTION_MODE_AES_256_XTS
+#define FS_POLICY_FLAGS_PAD_4          0x00
+#define FS_POLICY_FLAGS_PAD_8          0x01
+#define FS_POLICY_FLAGS_PAD_16         0x02
+#define FS_POLICY_FLAGS_PAD_32         0x03
+#define FS_POLICY_FLAGS_PAD_MASK       0x03
+#define FS_POLICY_FLAGS_VALID          0x03
+
+#define FS_ENCRYPTION_MODE_INVALID     0
+#define FS_ENCRYPTION_MODE_AES_256_XTS 1
+#define FS_ENCRYPTION_MODE_AES_256_GCM 2
+#define FS_ENCRYPTION_MODE_AES_256_CBC 3
+#define FS_ENCRYPTION_MODE_AES_256_CTS 4
+#endif /* FS_ENCRYPTION_MODE_AES_256_XTS */
+
+static cmdinfo_t get_encpolicy_cmd;
+static cmdinfo_t set_encpolicy_cmd;
+
+static void
+set_encpolicy_help(void)
+{
+       printf(_(
+"\n"
+" assign an encryption policy to the currently open file\n"
+"\n"
+" Examples:\n"
+" 'set_encpolicy' - assign policy with default key [0000000000000000]\n"
+" 'set_encpolicy 0000111122223333' - assign policy with specified key\n"
+"\n"
+" -c MODE -- contents encryption mode\n"
+" -n MODE -- filenames encryption mode\n"
+" -f FLAGS -- policy flags\n"
+" -v VERSION -- version of policy structure\n"
+"\n"
+" MODE can be numeric or one of the following predefined values:\n"
+"    AES-256-XTS, AES-256-CTS, AES-256-GCM, AES-256-CBC\n"
+" FLAGS and VERSION must be numeric.\n"
+"\n"
+" Note that it's only possible to set an encryption policy on an empty\n"
+" directory.  It's then inherited by new files and subdirectories.\n"
+"\n"));
+}
+
+static const struct {
+       __u8 mode;
+       const char *name;
+} available_modes[] = {
+       {FS_ENCRYPTION_MODE_AES_256_XTS, "AES-256-XTS"},
+       {FS_ENCRYPTION_MODE_AES_256_CTS, "AES-256-CTS"},
+       {FS_ENCRYPTION_MODE_AES_256_GCM, "AES-256-GCM"},
+       {FS_ENCRYPTION_MODE_AES_256_CBC, "AES-256-CBC"},
+};
+
+static bool
+parse_byte_value(const char *arg, __u8 *value_ret)
+{
+       long value;
+       char *tmp;
+
+       value = strtol(arg, &tmp, 0);
+       if (value < 0 || value > 255 || tmp == arg || *tmp != '\0')
+               return false;
+       *value_ret = value;
+       return true;
+}
+
+static bool
+parse_mode(const char *arg, __u8 *mode_ret)
+{
+       int i;
+
+       for (i = 0; i < ARRAY_SIZE(available_modes); i++) {
+               if (strcmp(arg, available_modes[i].name) == 0) {
+                       *mode_ret = available_modes[i].mode;
+                       return true;
+               }
+       }
+
+       return parse_byte_value(arg, mode_ret);
+}
+
+static const char *
+mode2str(__u8 mode)
+{
+       static char buf[32];
+       int i;
+
+       for (i = 0; i < ARRAY_SIZE(available_modes); i++)
+               if (mode == available_modes[i].mode)
+                       return available_modes[i].name;
+
+       sprintf(buf, "0x%02x", mode);
+       return buf;
+}
+
+static const char *
+keydesc2str(__u8 master_key_descriptor[FS_KEY_DESCRIPTOR_SIZE])
+{
+       static char buf[2 * FS_KEY_DESCRIPTOR_SIZE + 1];
+       int i;
+
+       for (i = 0; i < FS_KEY_DESCRIPTOR_SIZE; i++)
+               sprintf(&buf[2 * i], "%02x", master_key_descriptor[i]);
+
+       return buf;
+}
+
+static int
+get_encpolicy_f(int argc, char **argv)
+{
+       struct fscrypt_policy policy;
+
+       if (ioctl(file->fd, FS_IOC_GET_ENCRYPTION_POLICY, &policy) < 0) {
+               fprintf(stderr, "%s: failed to get encryption policy: %s\n",
+                       file->name, strerror(errno));
+               exitcode = 1;
+               return 0;
+       }
+
+       printf("Encryption policy for %s:\n", file->name);
+       printf("\tPolicy version: %u\n", policy.version);
+       printf("\tMaster key descriptor: %s\n",
+              keydesc2str(policy.master_key_descriptor));
+       printf("\tContents encryption mode: %u (%s)\n",
+              policy.contents_encryption_mode,
+              mode2str(policy.contents_encryption_mode));
+       printf("\tFilenames encryption mode: %u (%s)\n",
+              policy.filenames_encryption_mode,
+              mode2str(policy.filenames_encryption_mode));
+       printf("\tFlags: 0x%02x\n", policy.flags);
+       return 0;
+}
+
+static int
+set_encpolicy_f(int argc, char **argv)
+{
+       int c;
+       struct fscrypt_policy policy;
+
+       /* Initialize the policy structure with default values */
+       memset(&policy, 0, sizeof(policy));
+       policy.contents_encryption_mode = FS_ENCRYPTION_MODE_AES_256_XTS;
+       policy.filenames_encryption_mode = FS_ENCRYPTION_MODE_AES_256_CTS;
+       policy.flags = FS_POLICY_FLAGS_PAD_16;
+
+       /* Parse options */
+       while ((c = getopt(argc, argv, "c:n:f:v:")) != EOF) {
+               switch (c) {
+               case 'c':
+                       if (!parse_mode(optarg,
+                                       &policy.contents_encryption_mode)) {
+                               fprintf(stderr, "invalid contents encryption "
+                                       "mode: %s\n", optarg);
+                               return 0;
+                       }
+                       break;
+               case 'n':
+                       if (!parse_mode(optarg,
+                                       &policy.filenames_encryption_mode)) {
+                               fprintf(stderr, "invalid filenames encryption "
+                                       "mode: %s\n", optarg);
+                               return 0;
+                       }
+                       break;
+               case 'f':
+                       if (!parse_byte_value(optarg, &policy.flags)) {
+                               fprintf(stderr, "invalid flags: %s\n", optarg);
+                               return 0;
+                       }
+                       break;
+               case 'v':
+                       if (!parse_byte_value(optarg, &policy.version)) {
+                               fprintf(stderr, "invalid policy version: %s\n",
+                                       optarg);
+                               return 0;
+                       }
+                       break;
+               default:
+                       return command_usage(&set_encpolicy_cmd);
+               }
+       }
+       argc -= optind;
+       argv += optind;
+
+       if (argc > 1)
+               return command_usage(&set_encpolicy_cmd);
+
+       /* Parse key descriptor if specified */
+       if (argc > 0) {
+               const char *keydesc = argv[0];
+               char *tmp;
+               unsigned long long x;
+               int i;
+
+               if (strlen(keydesc) != FS_KEY_DESCRIPTOR_SIZE * 2) {
+                       fprintf(stderr, "invalid key descriptor: %s\n",
+                               keydesc);
+                       return 0;
+               }
+
+               x = strtoull(keydesc, &tmp, 16);
+               if (tmp == keydesc || *tmp != '\0') {
+                       fprintf(stderr, "invalid key descriptor: %s\n",
+                               keydesc);
+                       return 0;
+               }
+
+               for (i = 0; i < FS_KEY_DESCRIPTOR_SIZE; i++) {
+                       policy.master_key_descriptor[i] = x >> 56;
+                       x <<= 8;
+               }
+       }
+
+       /* Set the encryption policy */
+       if (ioctl(file->fd, FS_IOC_SET_ENCRYPTION_POLICY, &policy) < 0) {
+               fprintf(stderr, "%s: failed to set encryption policy: %s\n",
+                       file->name, strerror(errno));
+               exitcode = 1;
+               return 0;
+       }
+
+       return 0;
+}
+
+void
+encrypt_init(void)
+{
+       get_encpolicy_cmd.name = "get_encpolicy";
+       get_encpolicy_cmd.cfunc = get_encpolicy_f;
+       get_encpolicy_cmd.argmin = 0;
+       get_encpolicy_cmd.argmax = 0;
+       get_encpolicy_cmd.flags = CMD_NOMAP_OK | CMD_FOREIGN_OK;
+       get_encpolicy_cmd.oneline =
+               _("display the encryption policy of the current file");
+
+       set_encpolicy_cmd.name = "set_encpolicy";
+       set_encpolicy_cmd.cfunc = set_encpolicy_f;
+       set_encpolicy_cmd.args =
+               _("[-c mode] [-n mode] [-f flags] [-v version] [keydesc]");
+       set_encpolicy_cmd.argmin = 0;
+       set_encpolicy_cmd.argmax = -1;
+       set_encpolicy_cmd.flags = CMD_NOMAP_OK | CMD_FOREIGN_OK;
+       set_encpolicy_cmd.oneline =
+               _("assign an encryption policy to the current file");
+       set_encpolicy_cmd.help = set_encpolicy_help;
+
+       add_command(&get_encpolicy_cmd);
+       add_command(&set_encpolicy_cmd);
+}
index a9191cfa072d4193d5bad9966a8d52f3d1d524bf..ee7683ef99c6c267ee01046fb1b08a4fe04a6c20 100644 (file)
--- a/io/init.c
+++ b/io/init.c
@@ -59,6 +59,7 @@ init_commands(void)
        attr_init();
        bmap_init();
        copy_range_init();
+       encrypt_init();
        fadvise_init();
        file_init();
        flink_init();
diff --git a/io/io.h b/io/io.h
index 5d21314cf5333d55dbe0cdeb417d07bc73daf497..d257daafde6e5dd9f050b6f4745ca5e82d23d5d4 100644 (file)
--- a/io/io.h
+++ b/io/io.h
@@ -94,6 +94,7 @@ extern void           dump_buffer(off64_t, ssize_t);
 
 extern void            attr_init(void);
 extern void            bmap_init(void);
+extern void            encrypt_init(void);
 extern void            file_init(void);
 extern void            flink_init(void);
 extern void            freeze_init(void);
index efdba135c881e831f41a53c0a11088293e8c0913..fd6f41d50faa4df9e11243ecbae633b23b650dbf 100644 (file)
@@ -886,6 +886,33 @@ verbose output will be printed.
 .IP
 .B [NOTE: Not currently operational on Linux.]
 .PD
+.TP
+.BI "set_encpolicy [ \-c " mode " ] [ \-n " mode " ] [ \-f " flags " ] [ \-v " version " ] [ " keydesc " ]
+On filesystems that support encryption, assign an encryption policy to the
+current file.
+.I keydesc
+is a 16-byte hex string which identifies the encryption key to use.
+If not specified, a "default" key descriptor of all 0's will be used.
+.RS 1.0i
+.PD 0
+.TP 0.4i
+.BI \-c " mode
+contents encryption mode (e.g. AES-256-XTS)
+.TP
+.BI \-n " mode
+filenames encryption mode (e.g. AES-256-CTS)
+.TP
+.BI \-f " flags
+policy flags (numeric)
+.TP
+.BI \-v " version
+version of policy structure (numeric)
+.RE
+.PD
+.TP
+.BR get_encpolicy
+On filesystems that support encryption, display the encryption policy of the
+current file.
 
 .SH SEE ALSO
 .BR mkfs.xfs (8),