Skip to main content

vserver name-mapping modify

Contributors
Suggest changes
PDFs

Modify a name mapping's pattern, replacement pattern, or both

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

Description

The vserver name-mapping modify command modifies the pattern, the replacement pattern, or both of a specified name mapping.

You can specify patterns as POSIX regular expressions. For information about regular expressions, see the UNIX reference page for regex(7) .

Each Vserver can have up to 12500 name mappings in each direction.

Note If you are using the CLI, you must delimit all regular expressions with double quotation marks ("). For instance, to enter the regular expression (.) in the CLI, type "(.)" at the command prompt. To add a "?" to the expression, press ESC followed by the "?".

Parameters

-vserver <vserver name> - Vserver

This parameter specifies the Vserver on which you want to modify the name mapping.

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

This parameter specifies the direction of the name mapping. Possible values are krb-unix for a Kerberos-to-UNIX name mapping, win-unix for a Windows-to-UNIX name mapping, unix-win for a UNIX-to-Windows name mapping, s3-unix for a S3-to-UNIX name mapping and s3-win for a S3-to-Windows name mapping.

-position <integer> - Position

This parameter specifies the name mapping's position in the priority list. A position is specified as a positive integer. Each mapping direction (Kerberos-to-UNIX, Windows-to-UNIX, UNIX-to-Windows, S3-to-UNIX and S3-to-Windows) has its own priority list.

[-pattern <text>] - Pattern

This parameter specifies the pattern you want to match. Refer to the command description section for details. The pattern can be up to 256 characters in length.

[-replacement <text>] - Replacement

This parameter specifies the replacement pattern. The replacement pattern can be up to 256 characters in length.

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

This optional parameter specifies the IP address that can be used to match the client's workstation IP address with the pattern.

| [-hostname <text>] - Hostname }

This optional parameter specifies the hostname that can be used to match the corresponding client's workstation IP address with the list of IP addresses with the pattern.

Examples

The following example modifies the name mapping on the Vserver named vs1 and direction win-unix, at position 3. The pattern to be matched is changed to "EXAMPLE\(.+)".

cluster1::> vserver name-mapping modify -vserver vs1 -direction win-unix -position 3 -pattern "EXAMPLE\\(.+) -address 10.238.2.54/32"
cluster1::> vserver name-mapping modify -vserver vs1 -direction win-unix -position 3 -pattern "EXAMPLE\\(.+) -hostname google.com"