summaryrefslogtreecommitdiffstats
path: root/man/man1/getsubids.1
diff options
context:
space:
mode:
Diffstat (limited to 'man/man1/getsubids.1')
-rw-r--r--man/man1/getsubids.182
1 files changed, 82 insertions, 0 deletions
diff --git a/man/man1/getsubids.1 b/man/man1/getsubids.1
new file mode 100644
index 0000000..2d92334
--- /dev/null
+++ b/man/man1/getsubids.1
@@ -0,0 +1,82 @@
+'\" t
+.\" Title: getsubids
+.\" Author: Iker Pedrosa
+.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
+.\" Date: 11/08/2022
+.\" Manual: User Commands
+.\" Source: shadow-utils 4.13
+.\" Language: English
+.\"
+.TH "GETSUBIDS" "1" "11/08/2022" "shadow\-utils 4\&.13" "User Commands"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+getsubids \- get the subordinate id ranges for a user
+.SH "SYNOPSIS"
+.HP \w'\fBgetsubids\fR\ 'u
+\fBgetsubids\fR [\fIoptions\fR] \fIUSER\fR
+.SH "DESCRIPTION"
+.PP
+The
+\fBgetsubids\fR
+command lists the subordinate user ID ranges for a given user\&. The subordinate group IDs can be listed using the
+\fB\-g\fR
+option\&.
+.SH "OPTIONS"
+.PP
+The options which apply to the
+\fBgetsubids\fR
+command are:
+.PP
+\fB\-g\fR
+.RS 4
+List the subordinate group ID ranges\&.
+.RE
+.PP
+\fB\-h\fR
+.RS 4
+Display help message and exit\&.
+.RE
+.SH "EXAMPLE"
+.PP
+For example, to obtain the subordinate UIDs of the testuser:
+.PP
+.if n \{\
+.RS 4
+.\}
+.nf
+$ getsubids testuser
+0: testuser 100000 65536
+.fi
+.if n \{\
+.RE
+.\}
+.PP
+This command output provides (in order from left to right) the list index, username, UID range start, and number of UIDs in range\&.
+.SH "SEE ALSO"
+.PP
+\fBlogin.defs\fR(5),
+\fBnewgidmap\fR(1),
+\fBnewuidmap\fR(1),
+\fBsubgid\fR(5),
+\fBsubuid\fR(5),
+\fBuseradd\fR(8),
+\fBuserdel\fR(8)\&.
+\fBusermod\fR(8),