Skip to main content

vserver name-mapping show

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
  • 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}] - 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