From 23b2f8a1e762448a4120126a860ba9e9b033510e Mon Sep 17 00:00:00 2001
From: Christopher Head <chead@chead.ca>
Date: Sat, 14 Jan 2023 22:16:44 -0800
Subject: [PATCH] btrfs-progs: docs: add struct
 btrfs_ioctl_get_subvol_info_args

Author: Christopher Head <chead@chead.ca>
Signed-off-by: David Sterba <dsterba@suse.com>
---
 Documentation/btrfs-ioctl.rst | 57 +++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)

diff --git a/Documentation/btrfs-ioctl.rst b/Documentation/btrfs-ioctl.rst
index 55eecfff..968089d6 100644
--- a/Documentation/btrfs-ioctl.rst
+++ b/Documentation/btrfs-ioctl.rst
@@ -48,6 +48,63 @@ DATA STRUCTURES AND DEFINITIONS
             };
    };
 
+.. code-block::
+
+   struct btrfs_ioctl_get_subvol_info_args {
+        /* Id of this subvolume */
+        __u64 treeid;
+
+        /* Name of this subvolume, used to get the real name at mount point */
+        char name[BTRFS_VOL_NAME_MAX + 1];
+
+        /*
+         * Id of the subvolume which contains this subvolume.
+         * Zero for top-level subvolume or a deleted subvolume.
+         */
+        __u64 parent_id;
+
+        /*
+         * Inode number of the directory which contains this subvolume.
+         * Zero for top-level subvolume or a deleted subvolume
+         */
+        __u64 dirid;
+
+        /* Latest transaction id of this subvolume */
+        __u64 generation;
+
+        /* Flags of this subvolume */
+        __u64 flags;
+
+        /* UUID of this subvolume */
+        __u8 uuid[BTRFS_UUID_SIZE];
+
+        /*
+         * UUID of the subvolume of which this subvolume is a snapshot.
+         * All zero for a non-snapshot subvolume.
+         */
+        __u8 parent_uuid[BTRFS_UUID_SIZE];
+
+        /*
+         * UUID of the subvolume from which this subvolume was received.
+         * All zero for non-received subvolume.
+         */
+        __u8 received_uuid[BTRFS_UUID_SIZE];
+
+        /* Transaction id indicating when change/create/send/receive happened */
+        __u64 ctransid;
+        __u64 otransid;
+        __u64 stransid;
+        __u64 rtransid;
+        /* Time corresponding to c/o/s/rtransid */
+        struct btrfs_ioctl_timespec ctime;
+        struct btrfs_ioctl_timespec otime;
+        struct btrfs_ioctl_timespec stime;
+        struct btrfs_ioctl_timespec rtime;
+
+        /* Must be zero */
+        __u64 reserved[8];
+   };
+
 .. code-block::
 
    BTRFS_SUBVOL_NAME_MAX = 4039