Supported expansion variables

You can include expansion variables in an SMB share path or in an authentication provider's home directory template.

OneFS supports the following expansion variables. You can improve performance and reduce the number of shares to be managed when you configure shares with expansion variables. For example, you can include the %U variable for a share rather than create a share for each user. When a %U is included in the name so that each user's path is different, security is still ensured because each user can view and access only his or her home directory.

Note Image

When you create an SMB share through the web administration interface, you must select the Allow Variable Expansion check box or the string is interpreted literally by the system.

Variable
Value
Description
%U
User name (for example, user_001)
Expands to the user name to allow different users to use different home directories. This variable is typically included at the end of the path. For example, for a user named user1, the path /ifs/home/%U is mapped to /ifs/home/user1.
%D
NetBIOS domain name (for example, YORK for YORK.EAST.EXAMPLE.COM)
Expands to the user's domain name, based on the authentication provider:
  • For Active Directory users, %D expands to the Active Directory NetBIOS name.
  • For local users, %D expands to the cluster name in uppercase characters. For example, for a cluster named cluster1, %D expands to CLUSTER1.
  • For users in the System file provider, %D expands to UNIX_USERS.
  • For users in other file providers, %D expands to FILE_USERS.
  • For LDAP users, %D expands to LDAP_USERS.
  • For NIS users, %D expands to NIS_USERS.
%Z
Zone name (for example, ZoneABC)
Expands to the access zone name. If multiple zones are activated, this variable is useful for differentiating users in separate zones. For example, for a user named user1 in the System zone, the path /ifs/home/%Z/%U is mapped to /ifs/home/System/user1.
%L
Host name (cluster host name in lowercase)
Expands to the host name of the cluster, normalized to lowercase. Limited use.
%0
First character of the user name
Expands to the first character of the user name.
%1
Second character of the user name
Expands to the second character of the user name.
%2
Third character of the user name
Expands to the third character of the user name.
Note Image

If the user name includes fewer than three characters, the %0, %1, and %2 variables wrap around. For example, for a user named ab, the variables maps to a, b, and a, respectively. For a user named a, all three variables map to a.