bump dependencies

Signed-off-by: Jörn Friedrich Dreyer <jfd@butonic.de>
2024-10-18 17:35:30 +02:00
parent 290477b494
commit ca113f5751
522 changed files with 93151 additions and 33036 deletions
@@ -28,7 +28,8 @@ type CloneOptions struct {
 // specified using the clone options parameter.
 //
 // Similar To:
-//  ceph fs subvolume snapshot clone <volume> --group_name=<group> <subvolume> <snapshot> <name> [...]
+//
+//	ceph fs subvolume snapshot clone <volume> --group_name=<group> <subvolume> <snapshot> <name> [...]
 func (fsa *FSAdmin) CloneSubVolumeSnapshot(volume, group, subvolume, snapshot, name string, o *CloneOptions) error {
 	m := map[string]string{
 		"prefix":          "fs subvolume snapshot clone",
@@ -114,7 +115,8 @@ func parseCloneStatus(res response) (*CloneStatus, error) {
 // CloneStatus returns data reporting the status of a subvolume clone.
 //
 // Similar To:
-//  ceph fs clone status <volume> --group_name=<group> <clone>
+//
+//	ceph fs clone status <volume> --group_name=<group> <clone>
 func (fsa *FSAdmin) CloneStatus(volume, group, clone string) (*CloneStatus, error) {
 	m := map[string]string{
 		"prefix":     "fs clone status",
@@ -132,7 +134,8 @@ func (fsa *FSAdmin) CloneStatus(volume, group, clone string) (*CloneStatus, erro
 // CancelClone does not delete the clone.
 //
 // Similar To:
-//  ceph fs clone cancel <volume> --group_name=<group> <clone>
+//
+//	ceph fs clone cancel <volume> --group_name=<group> <clone>
 func (fsa *FSAdmin) CancelClone(volume, group, clone string) error {
 	m := map[string]string{
 		"prefix":     "fs clone cancel",
@@ -3,8 +3,9 @@ package admin
 // GetFailure returns details about the CloneStatus when in CloneFailed state.
 //
 // Similar To:
-//  Reading the .failure object from the JSON returned by "ceph fs subvolume
-//  snapshot clone"
+//
+//	Reading the .failure object from the JSON returned by "ceph fs subvolume
+//	snapshot clone"
 func (cs *CloneStatus) GetFailure() *CloneFailure {
 	return cs.failure
 }
@@ -0,0 +1,133 @@
+package admin
+
+import "fmt"
+
+// fixedPointFloat is a custom type that implements the MarshalJSON interface.
+// This is used to format float64 values to two decimal places.
+// By default these get converted to integers in the JSON output and
+// fail the command.
+type fixedPointFloat float64
+
+// MarshalJSON provides a custom implementation for the JSON marshalling
+// of fixedPointFloat. It formats the float to two decimal places.
+func (fpf fixedPointFloat) MarshalJSON() ([]byte, error) {
+	return []byte(fmt.Sprintf("%.2f", float64(fpf))), nil
+}
+
+// fSQuiesceFields is the internal type used to create JSON for ceph.
+// See FSQuiesceOptions for the type that users of the library
+// interact with.
+type fSQuiesceFields struct {
+	Prefix     string          `json:"prefix"`
+	VolName    string          `json:"vol_name"`
+	GroupName  string          `json:"group_name,omitempty"`
+	Members    []string        `json:"members,omitempty"`
+	SetId      string          `json:"set_id,omitempty"`
+	Timeout    fixedPointFloat `json:"timeout,omitempty"`
+	Expiration fixedPointFloat `json:"expiration,omitempty"`
+	AwaitFor   fixedPointFloat `json:"await_for,omitempty"`
+	Await      bool            `json:"await,omitempty"`
+	IfVersion  int             `json:"if_version,omitempty"`
+	Include    bool            `json:"include,omitempty"`
+	Exclude    bool            `json:"exclude,omitempty"`
+	Reset      bool            `json:"reset,omitempty"`
+	Release    bool            `json:"release,omitempty"`
+	Query      bool            `json:"query,omitempty"`
+	All        bool            `json:"all,omitempty"`
+	Cancel     bool            `json:"cancel,omitempty"`
+}
+
+// FSQuiesceOptions are used to specify optional, non-identifying, values
+// to be used when quiescing a cephfs volume.
+type FSQuiesceOptions struct {
+	Timeout    float64
+	Expiration float64
+	AwaitFor   float64
+	Await      bool
+	IfVersion  int
+	Include    bool
+	Exclude    bool
+	Reset      bool
+	Release    bool
+	Query      bool
+	All        bool
+	Cancel     bool
+}
+
+// toFields is used to convert the FSQuiesceOptions to the internal
+// fSQuiesceFields type.
+func (o *FSQuiesceOptions) toFields(volume, group string, subvolumes []string, setId string) *fSQuiesceFields {
+	return &fSQuiesceFields{
+		Prefix:     "fs quiesce",
+		VolName:    volume,
+		GroupName:  group,
+		Members:    subvolumes,
+		SetId:      setId,
+		Timeout:    fixedPointFloat(o.Timeout),
+		Expiration: fixedPointFloat(o.Expiration),
+		AwaitFor:   fixedPointFloat(o.AwaitFor),
+		Await:      o.Await,
+		IfVersion:  o.IfVersion,
+		Include:    o.Include,
+		Exclude:    o.Exclude,
+		Reset:      o.Reset,
+		Release:    o.Release,
+		Query:      o.Query,
+		All:        o.All,
+		Cancel:     o.Cancel,
+	}
+}
+
+// QuiesceState is used to report the state of a quiesced fs volume.
+type QuiesceState struct {
+	Name string  `json:"name"`
+	Age  float64 `json:"age"`
+}
+
+// QuiesceInfoMember is used to report the state of a quiesced fs volume.
+// This is part of sets members object array in the json.
+type QuiesceInfoMember struct {
+	Excluded bool         `json:"excluded"`
+	State    QuiesceState `json:"state"`
+}
+
+// QuiesceInfo reports various informational values about a quiesced volume.
+// This is returned as sets object array in the json.
+type QuiesceInfo struct {
+	Version    int                          `json:"version"`
+	AgeRef     float64                      `json:"age_ref"`
+	State      QuiesceState                 `json:"state"`
+	Timeout    float64                      `json:"timeout"`
+	Expiration float64                      `json:"expiration"`
+	Members    map[string]QuiesceInfoMember `json:"members"`
+}
+
+// FSQuiesceInfo reports various informational values about quiesced volumes.
+type FSQuiesceInfo struct {
+	Epoch      int                    `json:"epoch"`
+	SetVersion int                    `json:"set_version"`
+	Sets       map[string]QuiesceInfo `json:"sets"`
+}
+
+// parseFSQuiesceInfo is used to parse the response from the quiesce command. It returns a FSQuiesceInfo object.
+func parseFSQuiesceInfo(res response) (*FSQuiesceInfo, error) {
+	var info FSQuiesceInfo
+	if err := res.NoStatus().Unmarshal(&info).End(); err != nil {
+		return nil, err
+	}
+	return &info, nil
+}
+
+// FSQuiesce will quiesce the specified subvolumes in a volume.
+// Quiescing a fs will prevent new writes to the subvolumes.
+// Similar To:
+//
+// ceph fs quiesce <volume>
+func (fsa *FSAdmin) FSQuiesce(volume, group string, subvolumes []string, setId string, o *FSQuiesceOptions) (*FSQuiesceInfo, error) {
+	if o == nil {
+		o = &FSQuiesceOptions{}
+	}
+	f := o.toFields(volume, group, subvolumes, setId)
+
+	return parseFSQuiesceInfo(fsa.marshalMgrCommand(f))
+}
@@ -17,26 +17,6 @@ type FSAdmin struct {
 	conn RadosCommander
 }

-// New creates an FSAdmin automatically based on the default ceph
-// configuration file. If more customization is needed, create a
-// *rados.Conn as you see fit and use NewFromConn to use that
-// connection with these administrative functions.
-func New() (*FSAdmin, error) {
-	conn, err := rados.NewConn()
-	if err != nil {
-		return nil, err
-	}
-	err = conn.ReadDefaultConfigFile()
-	if err != nil {
-		return nil, err
-	}
-	err = conn.Connect()
-	if err != nil {
-		return nil, err
-	}
-	return NewFromConn(conn), nil
-}
-
 // NewFromConn creates an FSAdmin management object from a preexisting
 // rados connection. The existing connection can be rados.Conn or any
 // type implementing the RadosCommander interface. This may be useful
@@ -1,5 +1,5 @@
-//go:build !(nautilus || octopus) && ceph_preview && ceph_pre_quincy
-// +build !nautilus,!octopus,ceph_preview,ceph_pre_quincy
+//go:build !(nautilus || octopus || pacific)
+// +build !nautilus,!octopus,!pacific

 package admin

@@ -7,7 +7,8 @@ package admin
 // an optional subvolume group based on provided key name.
 //
 // Similar To:
-//  ceph fs subvolume metadata get <vol_name> <sub_name> <key_name> [--group_name <subvol_group_name>]
+//
+//	ceph fs subvolume metadata get <vol_name> <sub_name> <key_name> [--group_name <subvol_group_name>]
 func (fsa *FSAdmin) GetMetadata(volume, group, subvolume, key string) (string, error) {
 	m := map[string]string{
 		"prefix":   "fs subvolume metadata get",
@@ -28,7 +29,8 @@ func (fsa *FSAdmin) GetMetadata(volume, group, subvolume, key string) (string, e
 // an optional subvolume group as a key-value pair.
 //
 // Similar To:
-//  ceph fs subvolume metadata set <vol_name> <sub_name> <key_name> <value> [--group_name <subvol_group_name>]
+//
+//	ceph fs subvolume metadata set <vol_name> <sub_name> <key_name> <value> [--group_name <subvol_group_name>]
 func (fsa *FSAdmin) SetMetadata(volume, group, subvolume, key, value string) error {
 	m := map[string]string{
 		"prefix":   "fs subvolume metadata set",
@@ -50,7 +52,8 @@ func (fsa *FSAdmin) SetMetadata(volume, group, subvolume, key, value string) err
 // belonging to an optional subvolume group using the metadata key.
 //
 // Similar To:
-//  ceph fs subvolume metadata rm <vol_name> <sub_name> <key_name> [--group_name <subvol_group_name>]
+//
+//	ceph fs subvolume metadata rm <vol_name> <sub_name> <key_name> [--group_name <subvol_group_name>]
 func (fsa *FSAdmin) RemoveMetadata(volume, group, subvolume, key string) error {
 	return fsa.rmSubVolumeMetadata(volume, group, subvolume, key, commonRmFlags{})
 }
@@ -60,7 +63,8 @@ func (fsa *FSAdmin) RemoveMetadata(volume, group, subvolume, key string) error {
 // the metadata key.
 //
 // Similar To:
-//  ceph fs subvolume metadata rm <vol_name> <sub_name> <key_name> [--group_name <subvol_group_name>] --force
+//
+//	ceph fs subvolume metadata rm <vol_name> <sub_name> <key_name> [--group_name <subvol_group_name>] --force
 func (fsa *FSAdmin) ForceRemoveMetadata(volume, group, subvolume, key string) error {
 	return fsa.rmSubVolumeMetadata(volume, group, subvolume, key, commonRmFlags{force: true})
 }
@@ -85,7 +89,8 @@ func (fsa *FSAdmin) rmSubVolumeMetadata(volume, group, subvolume, key string, o
 // in a volume belonging to an optional subvolume group.
 //
 // Similar To:
-//  ceph fs subvolume metadata ls <vol_name> <sub_name> [--group_name <subvol_group_name>]
+//
+//	ceph fs subvolume metadata ls <vol_name> <sub_name> [--group_name <subvol_group_name>]
 func (fsa *FSAdmin) ListMetadata(volume, group, subvolume string) (map[string]string, error) {
 	m := map[string]string{
 		"prefix":   "fs subvolume metadata ls",
@@ -9,7 +9,8 @@ const mirroring = "mirroring"
 // EnableMirroringModule will enable the mirroring module for cephfs.
 //
 // Similar To:
-//  ceph mgr module enable mirroring [--force]
+//
+//	ceph mgr module enable mirroring [--force]
 func (fsa *FSAdmin) EnableMirroringModule(force bool) error {
 	mgradmin := manager.NewFromConn(fsa.conn)
 	return mgradmin.EnableModule(mirroring, force)
@@ -18,7 +19,8 @@ func (fsa *FSAdmin) EnableMirroringModule(force bool) error {
 // DisableMirroringModule will disable the mirroring module for cephfs.
 //
 // Similar To:
-//  ceph mgr module disable mirroring
+//
+//	ceph mgr module disable mirroring
 func (fsa *FSAdmin) DisableMirroringModule() error {
 	mgradmin := manager.NewFromConn(fsa.conn)
 	return mgradmin.DisableModule(mirroring)
@@ -20,7 +20,8 @@ func (fsa *FSAdmin) SnapshotMirror() *SnapshotMirrorAdmin {
 // Enable snapshot mirroring for the given file system.
 //
 // Similar To:
-//  ceph fs snapshot mirror enable <fs_name>
+//
+//	ceph fs snapshot mirror enable <fs_name>
 func (sma *SnapshotMirrorAdmin) Enable(fsname string) error {
 	m := map[string]string{
 		"prefix":  "fs snapshot mirror enable",
@@ -33,7 +34,8 @@ func (sma *SnapshotMirrorAdmin) Enable(fsname string) error {
 // Disable snapshot mirroring for the given file system.
 //
 // Similar To:
-//  ceph fs snapshot mirror disable <fs_name>
+//
+//	ceph fs snapshot mirror disable <fs_name>
 func (sma *SnapshotMirrorAdmin) Disable(fsname string) error {
 	m := map[string]string{
 		"prefix":  "fs snapshot mirror disable",
@@ -46,7 +48,8 @@ func (sma *SnapshotMirrorAdmin) Disable(fsname string) error {
 // Add a path in the file system to be mirrored.
 //
 // Similar To:
-//  ceph fs snapshot mirror add <fs_name> <path>
+//
+//	ceph fs snapshot mirror add <fs_name> <path>
 func (sma *SnapshotMirrorAdmin) Add(fsname, path string) error {
 	m := map[string]string{
 		"prefix":  "fs snapshot mirror add",
@@ -60,7 +63,8 @@ func (sma *SnapshotMirrorAdmin) Add(fsname, path string) error {
 // Remove a path in the file system from mirroring.
 //
 // Similar To:
-//  ceph fs snapshot mirror remove <fs_name> <path>
+//
+//	ceph fs snapshot mirror remove <fs_name> <path>
 func (sma *SnapshotMirrorAdmin) Remove(fsname, path string) error {
 	m := map[string]string{
 		"prefix":  "fs snapshot mirror remove",
@@ -79,7 +83,8 @@ type bootstrapTokenResponse struct {
 // a peering association between this site an another site.
 //
 // Similar To:
-//  ceph fs snapshot mirror peer_bootstrap create <fs_name> <client_entity> <site-name>
+//
+//	ceph fs snapshot mirror peer_bootstrap create <fs_name> <client_entity> <site-name>
 func (sma *SnapshotMirrorAdmin) CreatePeerBootstrapToken(
 	fsname, client, site string) (string, error) {
 	m := map[string]string{
@@ -100,7 +105,8 @@ func (sma *SnapshotMirrorAdmin) CreatePeerBootstrapToken(
 // that has provided a token, with the current site.
 //
 // Similar To:
-//  ceph fs snapshot mirror peer_bootstrap import <fs_name> <token>
+//
+//	ceph fs snapshot mirror peer_bootstrap import <fs_name> <token>
 func (sma *SnapshotMirrorAdmin) ImportPeerBoostrapToken(fsname, token string) error {
 	m := map[string]string{
 		"prefix":  "fs snapshot mirror peer_bootstrap import",
@@ -170,7 +176,8 @@ func parseDaemonStatus(res response) (DaemonStatusResults, error) {
 // associated with the given file system.
 //
 // Similar To:
-//  ceph fs snapshot mirror daemon status <fs_name>
+//
+//	ceph fs snapshot mirror daemon status <fs_name>
 func (sma *SnapshotMirrorAdmin) DaemonStatus(fsname string) (
 	DaemonStatusResults, error) {
 	// ---
@@ -204,7 +211,8 @@ func parsePeerList(res response) (PeerListResults, error) {
 // PeerList returns information about peers associated with the given file system.
 //
 // Similar To:
-//  ceph fs snapshot mirror peer_list <fs_name>
+//
+//	ceph fs snapshot mirror peer_list <fs_name>
 func (sma *SnapshotMirrorAdmin) PeerList(fsname string) (
 	PeerListResults, error) {
 	// ---
@@ -0,0 +1,46 @@
+//go:build !nautilus
+// +build !nautilus
+
+package admin
+
+// PinSubVolume pins subvolume to ranks according to policies. A valid pin
+// setting value depends on the type of pin as described in the docs from
+// https://docs.ceph.com/en/latest/cephfs/multimds/#cephfs-pinning and
+// https://docs.ceph.com/en/latest/cephfs/multimds/#setting-subtree-partitioning-policies
+//
+// Similar To:
+//
+//	ceph fs subvolume pin <vol_name> <sub_name> <pin_type> <pin_setting>
+func (fsa *FSAdmin) PinSubVolume(volume, subvolume, pintype, pinsetting string) (string, error) {
+	m := map[string]string{
+		"prefix":      "fs subvolume pin",
+		"format":      "json",
+		"vol_name":    volume,
+		"sub_name":    subvolume,
+		"pin_type":    pintype,
+		"pin_setting": pinsetting,
+	}
+
+	return parsePathResponse(fsa.marshalMgrCommand(m))
+}
+
+// PinSubVolumeGroup pins subvolume to ranks according to policies. A valid pin
+// setting value depends on the type of pin as described in the docs from
+// https://docs.ceph.com/en/latest/cephfs/multimds/#cephfs-pinning and
+// https://docs.ceph.com/en/latest/cephfs/multimds/#setting-subtree-partitioning-policies
+//
+// Similar To:
+//
+//	ceph fs subvolumegroup pin <vol_name> <group_name> <pin_type> <pin_setting>
+func (fsa *FSAdmin) PinSubVolumeGroup(volume, group, pintype, pinsetting string) (string, error) {
+	m := map[string]string{
+		"prefix":      "fs subvolumegroup pin",
+		"format":      "json",
+		"vol_name":    volume,
+		"group_name":  group,
+		"pin_type":    pintype,
+		"pin_setting": pinsetting,
+	}
+
+	return parsePathResponse(fsa.marshalMgrCommand(m))
+}
@@ -1,5 +1,5 @@
-//go:build !(nautilus || octopus) && ceph_preview && ceph_pre_quincy
-// +build !nautilus,!octopus,ceph_preview,ceph_pre_quincy
+//go:build !(nautilus || octopus || pacific)
+// +build !nautilus,!octopus,!pacific

 package admin

@@ -7,7 +7,8 @@ package admin
 // volume belonging to an optional subvolume group based on provided key name.
 //
 // Similar To:
-//  ceph fs subvolume snapshot metadata get <vol_name> <sub_name> <snap_name> <key_name> [--group_name <subvol_group_name>]
+//
+//	ceph fs subvolume snapshot metadata get <vol_name> <sub_name> <snap_name> <key_name> [--group_name <subvol_group_name>]
 func (fsa *FSAdmin) GetSnapshotMetadata(volume, group, subvolume, snapname, key string) (string, error) {
 	m := map[string]string{
 		"prefix":    "fs subvolume snapshot metadata get",
@@ -29,7 +30,8 @@ func (fsa *FSAdmin) GetSnapshotMetadata(volume, group, subvolume, snapname, key
 // volume belonging to an optional subvolume group as a key-value pair.
 //
 // Similar To:
-//  ceph fs subvolume snapshot metadata set <vol_name> <sub_name> <snap_name> <key_name> <value> [--group_name <subvol_group_name>]
+//
+//	ceph fs subvolume snapshot metadata set <vol_name> <sub_name> <snap_name> <key_name> <value> [--group_name <subvol_group_name>]
 func (fsa *FSAdmin) SetSnapshotMetadata(volume, group, subvolume, snapname, key, value string) error {
 	m := map[string]string{
 		"prefix":    "fs subvolume snapshot metadata set",
@@ -53,7 +55,8 @@ func (fsa *FSAdmin) SetSnapshotMetadata(volume, group, subvolume, snapname, key,
 // metadata key.
 //
 // Similar To:
-//  ceph fs subvolume snapshot metadata rm <vol_name> <sub_name> <snap_name> <key_name> [--group_name <subvol_group_name>]
+//
+//	ceph fs subvolume snapshot metadata rm <vol_name> <sub_name> <snap_name> <key_name> [--group_name <subvol_group_name>]
 func (fsa *FSAdmin) RemoveSnapshotMetadata(volume, group, subvolume, snapname, key string) error {
 	return fsa.rmSubVolumeSnapShotMetadata(volume, group, subvolume, snapname, key, commonRmFlags{})
 }
@@ -63,7 +66,8 @@ func (fsa *FSAdmin) RemoveSnapshotMetadata(volume, group, subvolume, snapname, k
 // subvolume group using the metadata key.
 //
 // Similar To:
-//  ceph fs subvolume snapshot metadata rm <vol_name> <sub_name> <snap_name> <key_name> [--group_name <subvol_group_name>] --force
+//
+//	ceph fs subvolume snapshot metadata rm <vol_name> <sub_name> <snap_name> <key_name> [--group_name <subvol_group_name>] --force
 func (fsa *FSAdmin) ForceRemoveSnapshotMetadata(volume, group, subvolume, snapname, key string) error {
 	return fsa.rmSubVolumeSnapShotMetadata(volume, group, subvolume, snapname, key, commonRmFlags{force: true})
 }
@@ -89,7 +93,8 @@ func (fsa *FSAdmin) rmSubVolumeSnapShotMetadata(volume, group, subvolume, snapna
 // snapshot in a volume belonging to an optional subvolume group.
 //
 // Similar To:
-//  ceph fs subvolume snapshot metadata ls <vol_name> <sub_name> <snap_name> [--group_name <subvol_group_name>]
+//
+//	ceph fs subvolume snapshot metadata ls <vol_name> <sub_name> <snap_name> [--group_name <subvol_group_name>]
 func (fsa *FSAdmin) ListSnapshotMetadata(volume, group, subvolume, snapname string) (map[string]string, error) {
 	m := map[string]string{
 		"prefix":    "fs subvolume snapshot metadata ls",
@@ -53,7 +53,8 @@ const NoGroup = ""
 // belonging to an optional subvolume group.
 //
 // Similar To:
-//  ceph fs subvolume create <volume> --group-name=<group> <name> ...
+//
+//	ceph fs subvolume create <volume> --group-name=<group> <name> ...
 func (fsa *FSAdmin) CreateSubVolume(volume, group, name string, o *SubVolumeOptions) error {
 	if o == nil {
 		o = &SubVolumeOptions{}
@@ -66,7 +67,8 @@ func (fsa *FSAdmin) CreateSubVolume(volume, group, name string, o *SubVolumeOpti
 // optional subvolume group.
 //
 // Similar To:
-//  ceph fs subvolume ls <volume> --group-name=<group>
+//
+//	ceph fs subvolume ls <volume> --group-name=<group>
 func (fsa *FSAdmin) ListSubVolumes(volume, group string) ([]string, error) {
 	m := map[string]string{
 		"prefix":   "fs subvolume ls",
@@ -83,7 +85,8 @@ func (fsa *FSAdmin) ListSubVolumes(volume, group string) ([]string, error) {
 // subvolume group.
 //
 // Similar To:
-//  ceph fs subvolume rm <volume> --group-name=<group> <name>
+//
+//	ceph fs subvolume rm <volume> --group-name=<group> <name>
 func (fsa *FSAdmin) RemoveSubVolume(volume, group, name string) error {
 	return fsa.RemoveSubVolumeWithFlags(volume, group, name, SubVolRmFlags{})
 }
@@ -92,7 +95,8 @@ func (fsa *FSAdmin) RemoveSubVolume(volume, group, name string) error {
 // subvolume group.
 //
 // Similar To:
-//  ceph fs subvolume rm <volume> --group-name=<group> <name> --force
+//
+//	ceph fs subvolume rm <volume> --group-name=<group> <name> --force
 func (fsa *FSAdmin) ForceRemoveSubVolume(volume, group, name string) error {
 	return fsa.RemoveSubVolumeWithFlags(volume, group, name, SubVolRmFlags{Force: true})
 }
@@ -104,7 +108,8 @@ func (fsa *FSAdmin) ForceRemoveSubVolume(volume, group, name string) error {
 // Equivalent to ForceRemoveSubVolume if only the "Force" flag is set.
 //
 // Similar To:
-//  ceph fs subvolume rm <volume> --group-name=<group> <name> [...flags...]
+//
+//	ceph fs subvolume rm <volume> --group-name=<group> <name> [...flags...]
 func (fsa *FSAdmin) RemoveSubVolumeWithFlags(volume, group, name string, o SubVolRmFlags) error {
 	m := map[string]string{
 		"prefix":   "fs subvolume rm",
@@ -141,7 +146,8 @@ type SubVolumeResizeResult struct {
 // prevent reducing the size of the volume below the current used size.
 //
 // Similar To:
-//  ceph fs subvolume resize <volume> --group-name=<group> <name> ...
+//
+//	ceph fs subvolume resize <volume> --group-name=<group> <name> ...
 func (fsa *FSAdmin) ResizeSubVolume(
 	volume, group, name string,
 	newSize QuotaSize, noShrink bool) (*SubVolumeResizeResult, error) {
@@ -166,7 +172,8 @@ func (fsa *FSAdmin) ResizeSubVolume(
 // SubVolumePath returns the path to the subvolume from the root of the file system.
 //
 // Similar To:
-//  ceph fs subvolume getpath <volume> --group-name=<group> <name>
+//
+//	ceph fs subvolume getpath <volume> --group-name=<group> <name>
 func (fsa *FSAdmin) SubVolumePath(volume, group, name string) (string, error) {
 	m := map[string]string{
 		"prefix":   "fs subvolume getpath",
@@ -258,7 +265,8 @@ func parseSubVolumeInfo(res response) (*SubVolumeInfo, error) {
 // SubVolumeInfo returns information about the specified subvolume.
 //
 // Similar To:
-//  ceph fs subvolume info <volume> --group-name=<group> <name>
+//
+//	ceph fs subvolume info <volume> --group-name=<group> <name>
 func (fsa *FSAdmin) SubVolumeInfo(volume, group, name string) (*SubVolumeInfo, error) {
 	m := map[string]string{
 		"prefix":   "fs subvolume info",
@@ -275,7 +283,8 @@ func (fsa *FSAdmin) SubVolumeInfo(volume, group, name string) (*SubVolumeInfo, e
 // CreateSubVolumeSnapshot creates a new snapshot from the source subvolume.
 //
 // Similar To:
-//  ceph fs subvolume snapshot create <volume> --group-name=<group> <source> <name>
+//
+//	ceph fs subvolume snapshot create <volume> --group-name=<group> <source> <name>
 func (fsa *FSAdmin) CreateSubVolumeSnapshot(volume, group, source, name string) error {
 	m := map[string]string{
 		"prefix":    "fs subvolume snapshot create",
@@ -293,7 +302,8 @@ func (fsa *FSAdmin) CreateSubVolumeSnapshot(volume, group, source, name string)
 // RemoveSubVolumeSnapshot removes the specified snapshot from the subvolume.
 //
 // Similar To:
-//  ceph fs subvolume snapshot rm <volume> --group-name=<group> <subvolume> <name>
+//
+//	ceph fs subvolume snapshot rm <volume> --group-name=<group> <subvolume> <name>
 func (fsa *FSAdmin) RemoveSubVolumeSnapshot(volume, group, subvolume, name string) error {
 	return fsa.rmSubVolumeSnapshot(volume, group, subvolume, name, commonRmFlags{})
 }
@@ -301,7 +311,8 @@ func (fsa *FSAdmin) RemoveSubVolumeSnapshot(volume, group, subvolume, name strin
 // ForceRemoveSubVolumeSnapshot removes the specified snapshot from the subvolume.
 //
 // Similar To:
-//  ceph fs subvolume snapshot rm <volume> --group-name=<group> <subvolume> <name> --force
+//
+//	ceph fs subvolume snapshot rm <volume> --group-name=<group> <subvolume> <name> --force
 func (fsa *FSAdmin) ForceRemoveSubVolumeSnapshot(volume, group, subvolume, name string) error {
 	return fsa.rmSubVolumeSnapshot(volume, group, subvolume, name, commonRmFlags{force: true})
 }
@@ -324,7 +335,8 @@ func (fsa *FSAdmin) rmSubVolumeSnapshot(volume, group, subvolume, name string, o
 // ListSubVolumeSnapshots returns a listing of snapshots for a given subvolume.
 //
 // Similar To:
-//  ceph fs subvolume snapshot ls <volume> --group-name=<group> <name>
+//
+//	ceph fs subvolume snapshot ls <volume> --group-name=<group> <name>
 func (fsa *FSAdmin) ListSubVolumeSnapshots(volume, group, name string) ([]string, error) {
 	m := map[string]string{
 		"prefix":   "fs subvolume snapshot ls",
@@ -358,7 +370,8 @@ func parseSubVolumeSnapshotInfo(res response) (*SubVolumeSnapshotInfo, error) {
 // SubVolumeSnapshotInfo returns information about the specified subvolume snapshot.
 //
 // Similar To:
-//  ceph fs subvolume snapshot info <volume> --group-name=<group> <subvolume> <name>
+//
+//	ceph fs subvolume snapshot info <volume> --group-name=<group> <subvolume> <name>
 func (fsa *FSAdmin) SubVolumeSnapshotInfo(volume, group, subvolume, name string) (*SubVolumeSnapshotInfo, error) {
 	m := map[string]string{
 		"prefix":    "fs subvolume snapshot info",
@@ -376,7 +389,8 @@ func (fsa *FSAdmin) SubVolumeSnapshotInfo(volume, group, subvolume, name string)
 // ProtectSubVolumeSnapshot protects the specified snapshot.
 //
 // Similar To:
-//  ceph fs subvolume snapshot protect <volume> --group-name=<group> <subvolume> <name>
+//
+//	ceph fs subvolume snapshot protect <volume> --group-name=<group> <subvolume> <name>
 func (fsa *FSAdmin) ProtectSubVolumeSnapshot(volume, group, subvolume, name string) error {
 	m := map[string]string{
 		"prefix":    "fs subvolume snapshot protect",
@@ -394,7 +408,8 @@ func (fsa *FSAdmin) ProtectSubVolumeSnapshot(volume, group, subvolume, name stri
 // UnprotectSubVolumeSnapshot removes protection from the specified snapshot.
 //
 // Similar To:
-//  ceph fs subvolume snapshot unprotect <volume> --group-name=<group> <subvolume> <name>
+//
+//	ceph fs subvolume snapshot unprotect <volume> --group-name=<group> <subvolume> <name>
 func (fsa *FSAdmin) UnprotectSubVolumeSnapshot(volume, group, subvolume, name string) error {
 	m := map[string]string{
 		"prefix":    "fs subvolume snapshot unprotect",
@@ -40,7 +40,8 @@ func (s *SubVolumeGroupOptions) toFields(v, g string) *subVolumeGroupFields {
 // CreateSubVolumeGroup sends a request to create a subvolume group in a volume.
 //
 // Similar To:
-//  ceph fs subvolumegroup create <volume> <group_name>  ...
+//
+//	ceph fs subvolumegroup create <volume> <group_name>  ...
 func (fsa *FSAdmin) CreateSubVolumeGroup(volume, name string, o *SubVolumeGroupOptions) error {
 	if o == nil {
 		o = &SubVolumeGroupOptions{}
@@ -53,7 +54,8 @@ func (fsa *FSAdmin) CreateSubVolumeGroup(volume, name string, o *SubVolumeGroupO
 // specified volume.
 //
 // Similar To:
-//  ceph fs subvolumegroup ls cephfs <volume>
+//
+//	ceph fs subvolumegroup ls cephfs <volume>
 func (fsa *FSAdmin) ListSubVolumeGroups(volume string) ([]string, error) {
 	res := fsa.marshalMgrCommand(map[string]string{
 		"prefix":   "fs subvolumegroup ls",
@@ -65,14 +67,16 @@ func (fsa *FSAdmin) ListSubVolumeGroups(volume string) ([]string, error) {

 // RemoveSubVolumeGroup will delete a subvolume group in a volume.
 // Similar To:
-//  ceph fs subvolumegroup rm <volume> <group_name>
+//
+//	ceph fs subvolumegroup rm <volume> <group_name>
 func (fsa *FSAdmin) RemoveSubVolumeGroup(volume, name string) error {
 	return fsa.rmSubVolumeGroup(volume, name, commonRmFlags{})
 }

 // ForceRemoveSubVolumeGroup will delete a subvolume group in a volume.
 // Similar To:
-//  ceph fs subvolumegroup rm <volume> <group_name> --force
+//
+//	ceph fs subvolumegroup rm <volume> <group_name> --force
 func (fsa *FSAdmin) ForceRemoveSubVolumeGroup(volume, name string) error {
 	return fsa.rmSubVolumeGroup(volume, name, commonRmFlags{force: true})
 }
@@ -91,7 +95,8 @@ func (fsa *FSAdmin) rmSubVolumeGroup(volume, name string, o commonRmFlags) error
 // file system.
 //
 // Similar To:
-//  ceph fs subvolumegroup getpath <volume> <group_name>
+//
+//	ceph fs subvolumegroup getpath <volume> <group_name>
 func (fsa *FSAdmin) SubVolumeGroupPath(volume, name string) (string, error) {
 	m := map[string]string{
 		"prefix":     "fs subvolumegroup getpath",
@@ -14,7 +14,8 @@ var (
 // ListVolumes return a list of volumes in this Ceph cluster.
 //
 // Similar To:
-//  ceph fs volume ls
+//
+//	ceph fs volume ls
 func (fsa *FSAdmin) ListVolumes() ([]string, error) {
 	res := fsa.rawMgrCommand(listVolumesCmd)
 	return parseListNames(res)
@@ -34,7 +35,8 @@ type FSPoolInfo struct {
 // file systems.
 //
 // Similar To:
-//  ceph fs ls
+//
+//	ceph fs ls
 func (fsa *FSAdmin) ListFileSystems() ([]FSPoolInfo, error) {
 	res := fsa.rawMonCommand(listFsCmd)
 	return parseFsList(res)
@@ -168,7 +170,8 @@ func parseVolumeStatus(res response) (*volumeStatusResponse, error) {
 // VolumeStatus returns a VolumeStatus object for the given volume name.
 //
 // Similar To:
-//  ceph fs status cephfs <name>
+//
+//	ceph fs status cephfs <name>
 func (fsa *FSAdmin) VolumeStatus(name string) (*VolumeStatus, error) {
 	res := fsa.marshalMgrCommand(map[string]string{
 		"fs":     name,
@@ -0,0 +1,48 @@
+//go:build !(nautilus || octopus)
+// +build !nautilus,!octopus
+
+package admin
+
+// PoolInfo reports various properties of a pool.
+type PoolInfo struct {
+	Available int    `json:"avail"`
+	Name      string `json:"name"`
+	Used      int    `json:"used"`
+}
+
+// PoolType indicates the type of pool related to a volume.
+type PoolType struct {
+	DataPool     []PoolInfo `json:"data"`
+	MetadataPool []PoolInfo `json:"metadata"`
+}
+
+// VolInfo holds various informational values about a volume.
+type VolInfo struct {
+	MonAddrs          []string `json:"mon_addrs"`
+	PendingSubvolDels int      `json:"pending_subvolume_deletions"`
+	Pools             PoolType `json:"pools"`
+	UsedSize          int      `json:"used_size"`
+}
+
+func parseVolumeInfo(res response) (*VolInfo, error) {
+	var info VolInfo
+	if err := res.NoStatus().Unmarshal(&info).End(); err != nil {
+		return nil, err
+	}
+	return &info, nil
+}
+
+// FetchVolumeInfo fetches the information of a CephFS volume.
+//
+// Similar To:
+//
+//	ceph fs volume info <vol_name>
+func (fsa *FSAdmin) FetchVolumeInfo(volume string) (*VolInfo, error) {
+	m := map[string]string{
+		"prefix":   "fs volume info",
+		"vol_name": volume,
+		"format":   "json",
+	}
+
+	return parseVolumeInfo(fsa.marshalMgrCommand(m))
+}