Skip to main content

vserver group-mapping show

Display group mappings

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description​

The vserver group-mapping show command displays information about group mappings. The command output depends on the parameter or parameters specified with the command. If you do not specify any parameters, the command displays the following information about all group mappings:

  • Vserver name

  • Direction of the mapping (krb-unix for Kerberos-to-UNIX, win-unix for Windows-to-UNIX, or unix-win for UNIX-to-Windows)

  • Position of the mapping in the priority list

  • Pattern to be matched

  • Replacement pattern

You can specify additional parameters to display only information that matches those parameters. For instance, to display information only about Kerberos-to-UNIX group mappings, run the command with the -direction krb-unix parameter.

The vserver group-mapping show command is not supported on Vservers with FlexVol volumes.

Parameters​

{ [-fields <fieldname>, ...]
If you specify the -fields <fieldname>, ... parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.
| [-instance ]}
If you specify the -instance parameter, the command displays detailed information about all fields.
[-vserver <vserver name>] - Vserver
If you specify this parameter, the command displays information only about the group mapping or mappings that match the specified Vserver.
[-direction {krb-unix|win-unix|unix-win}] - Name Mapping Direction
If you specify this parameter, the command displays information only about the group mapping or mappings that have the specified mapping direction.
[-position <integer>] - Position
If you specify this parameter, the command displays information only about the group mapping that has the specified position in the priority list.
[-pattern <text>] - Pattern
If you specify this parameter, the command displays information only about the group mapping or mappings that use the specified matching pattern. The pattern can be up to 256 characters in length. Refer to the command description section for details.
[-replacement <text>] - Replacement
If you specify this parameter, the command displays information only about the group mapping or mappings that use the specified replacement pattern.

Examples​

The following example displays information about all group mappings: 

cluster1::> vserver group-mapping show
Vserver        Direction Position
-------------- --------- --------
vs1            win-unix  1        Pattern: EXAMPLE\\artists
                              Replacement: nobody
vs1            unix-win  1        Pattern: EXAMPLE\\(.+)
                              Replacement: \_1
vs2            win-unix  1        Pattern: (.+)
                              Replacement: EXAMPLE\\artists