*-G*, *--supp-groups*::
Show information about supplementary groups.
-*-g*, **--groups**=_groups_::
+*-g*, *--groups* _groups_::
Only show data of users belonging to _groups_. More than one group may be specified; the list has to be comma-separated. Unknown group names are ignored.
+
Note that the relation between user and group may be invisible for the primary group if the user is not explicitly specified as group member (e.g., in _/etc/group_). If the command *lslogins* scans for groups then it uses the groups database only, and the user database with primary GID is not used at all.
*-L*, *--last*::
Display data containing information about the users' last login sessions.
-*-l*, **--logins**=_logins_::
+*-l*, *--logins* _logins_::
Only show data of users with a login specified in _logins_ (user names or user IDs). More than one login may be specified; the list has to be comma-separated. Unknown login names are ignored.
*-n*, *--newline*::
== OPTIONS
-*-c*, **--command**=__command__::
+*-c*, *--command* __command__::
Pass _command_ to the shell with the *-c* option.
*-f*, *--fast*::
Pass *-f* to the shell, which may or may not be useful, depending on the shell.
-*-g*, **--group**=__group__::
+*-g*, *--group* __group__::
Specify the primary group. This option is available to the root user only.
-*-G*, **--supp-group**=__group__::
+*-G*, *--supp-group* __group__::
Specify a supplementary group. This option is available to the root user only. The first specified supplementary group is also used as a primary group if the option *--group* is not specified.
*-*, *-l*, *--login*::
+
This feature is mostly designed for interactive sessions. If the standard input is not a terminal, but for example a pipe (e.g., *echo "date" | su --pty*), then the *ECHO* flag for the pseudo-terminal is disabled to avoid messy output.
-*-s*, **--shell**=__shell__::
+*-s*, *--shell* __shell__::
Run the specified _shell_ instead of the default. If the target user has a restricted shell (i.e., not listed in _/etc/shells_), the *--shell* option and the *SHELL* environment variables are ignored unless the calling user is root.
+
The shell to run is selected according to the following rules, in order:
Do not create a pseudo-terminal, opposite of *--pty* and *-P*.
Note that running without a pseudo-terminal opens the security risk of privilege escalation through TIOCSTI/TIOCLINUX ioctl command injection.
-*-w*, **--whitelist-environment**=__list__::
+*-w*, *--whitelist-environment* __list__::
Don't reset the environment variables specified in the comma-separated _list_ when clearing the environment for *--login*. The whitelist is ignored for the environment variables *HOME*, *SHELL*, *USER*, *LOGNAME*, and *PATH*.
include::man-common/help-version.adoc[]
*-M*, *--move*::
Move a subtree to some other place. See above, the subsection *The move operation*.
-*-m*, **--mkdir**[=__mode__]::
+*-m*, *--mkdir*[**=**__mode__]::
Allow to make a target directory (mountpoint) if it does not exist yet. Alias to "-o X-mount.mkdir[=mode]", the default mode is 0755. For more details see *X-mount.mkdir* below.
*--map-groups*, *--map-users* _inner_:_outer_:_count_::
Set the watchdog pre-timeout in seconds. A watchdog pre-timeout is a
notification generated by the watchdog before the watchdog reset might occur in
the event the watchdog has not been serviced. This notification is handled by
-the kernel and can be configured to take an action using sysfs or by **--setpregovernor**.
+the kernel and can be configured to take an action using sysfs or by *--setpregovernor*.
*-g*, *--setpregovernor* _governor_::
Set pre-timeout governor name. For available governors see default **wdctl** output.