vserver name-mapping show

Contributors

Display name mappings

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

Description

The vserver name-mapping show command displays information about name 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 name 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 name mappings, run the command with the -direction krb-unix parameter.

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 name mapping or mappings that match the specified Vserver.

[-direction {krb-unix|win-unix|unix-win|s3-unix|s3-win}] - Direction

If you specify this parameter, the command displays information only about the name mapping or mappings that have the specified mapping direction.

[-position <integer>] - Position

If you specify this parameter, the command displays information only about the name 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 name 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 name mapping or mappings that use the specified replacement pattern.

[-address <IP Address/Mask>] - IP Address with Subnet Mask

If you specify this parameter, the command displays information only about the name mapping or mappings that use the specified IP address.

[-hostname <text>] - Hostname

If you specify this parameter, the command displays information only about the name mapping or mappings that use the specified hostname.

Examples

The following example displays information about all name mappings:

cluster1::> vserver name-mapping show
Vserver:   vs1
Direction: win-unix
Position Hostname         IP Address/Mask
-------- ---------------- ----------------
1        google.com       -                  Pattern: EXAMPLE\\administrator
                                         Replacement: nobody
2        -                10.238.2.34/32     Pattern: EXAMPLE\\(.+)
                                         Replacement: \_1