the-bastion/doc/sphinx/plugins/restricted/accountList.rst
Stéphane Lesimple 8cc990ad57 feat: add filtering options to several cmds,nicify print_acls()
The commands selfListAccesses, accountListAccesses,
groupList, groupListServers, groupListGuestAccesses and
accountList now have options to filter their output through
pattern matching, with --include and --exclude.

The output from the commands using print_acls() is also more
human-friendly, with auto-adjusting column length, and empty
columns omitted.

Closes #60.
2021-05-25 09:42:28 +02:00

45 lines
1 KiB
ReStructuredText

============
accountList
============
List the bastion accounts
=========================
.. admonition:: usage
:class: cmdusage
--osh accountList [OPTIONS]
.. program:: accountList
.. option:: --account ACCOUNT
Only list the specified account. This is an easy way to check whether the account exists
.. option:: --inactive-only
Only list inactive accounts
.. option:: --audit
Show more verbose information (SLOW!), you need to be a bastion auditor
.. option:: --include PATTERN
Only show accounts whose name match the given PATTERN (see below)
This option can be used multiple times to refine results
.. option:: --exclude PATTERN
Omit accounts whose name match the given PATTERN (see below)
This option can be used multiple times.
Note that --exclude takes precedence over --include
**Note:** PATTERN supports the ``*`` and ``?`` wildcards.
If PATTERN is a simple string without wildcards, then names containing this string will be considered.