adding getsubid tool wrapper

Author: Dan Lavu

sssd_test_framework/utils/tools.py

@@ -742,6 +742,57 @@ def FromOutput(cls, stdout: str) -> ServicesEntry:
         return cls.FromDict(result)
 
 
+class SubIDEntry(object):
+    """
+    Combined subordinate ID ranges for user.
+    """
+
+    def __init__(self, id: int, name: str, range_start: int, range_size: int) -> None:
+
+        self.id: int = id
+        """ User id """
+
+        self.name: str = name
+        """ User name"""
+
+        self.range_start: int = range_start
+        """ SubID range start """
+
+        self.range_size: int = range_size
+        """  SubID range size """
+
+    def __str__(self) -> str:
+        return f"id:{self.id}, owner:{self.name}, start:{self.range_start}, size:{self.range_size})"
+
+    def __repr__(self) -> str:
+        return str(self)
+
+    @classmethod
+    def FromDict(cls, d: dict[str, Any]) -> SubIDEntry:
+        return cls(
+            id=d.get("id", ""),
+            name=d.get("name", ""),
+            range_start=d.get("range_start", 0),
+            range_size=d.get("range_size", 0),
+        )
+
+    @classmethod
+    def FromOutput(cls, stdout: str) -> SubIDEntry:
+        line = stdout.strip()
+        if ":" in line:
+            parts = line.split(":", 1)
+            if len(parts) == 2:
+                rest = parts[1].strip().split()
+                if len(rest) >= 3:
+                    return cls(
+                        id=int(parts[0].strip()),
+                        name=rest[0],
+                        range_start=int(rest[1]),
+                        range_size=int(rest[2]),
+                    )
+        return cls(id=0, name="", range_start=0, range_size=0)
+
+
 class LinuxToolsUtils(MultihostUtility[MultihostHost]):
     """
     Run various standard commands on remote host.
@@ -762,6 +813,27 @@ def __init__(self, host: MultihostHost, fs: LinuxFileSystem) -> None:
         self.__fs: LinuxFileSystem = fs
         self.__rollback: list[str] = []
 
+    def getsubid(self, name: str, group: bool = False) -> SubIDEntry | None:
+        """
+        Call ``getsubid $name``
+
+        :param name: User name.
+        :type name: str
+        :param group: Get group range switch, optional
+        :type group: bool, defaults to False
+        :return: SubIDEntry data, None if not found
+        :type: SubIDEntry | None
+        """
+        args = ""
+        if group:
+            args = "-g"
+
+        command = self.host.conn.run(f"getsubids {args} {name}", raise_on_error=False)
+        if command.rc != 0:
+            return None
+
+        return SubIDEntry.FromOutput(command.stdout)
+
     def id(self, name: str | int) -> IdEntry | None:
         """
         Run ``id`` command.