2.2.2.6 MapSvrMBCSMapString

 typedef opaque MapSvrMBCSMapString<MAXLINELEN>;

An XDR variable-length opaque data field, as specified in [RFC4506] section 4.10, whose maximum length is specified in bytes. The length is equal to the number of MBCS bytes encoded in the system OEMCP, including multibyte characters, as specified by the length field that precedes the byte stream. The value of the length field MUST NOT exceed the value MAXLINELEN. Minimum length is 0.

This type is used to define a single account map as a colon-delimited string of MBCS characters. This type is returned as an output from the map enumeration procedure. For more details, see section 2.2.3.2.

The format of MapSvrMBCSMapString is a sequence of colon-delimited fields. It has one of two forms, depending on the context: user map or group map, as follows.

For user map, MapSvrMBCSMapString has the following format.

 MapType:WindowsAccountName:AuthType:UNIXDomain:UNIXServer:
 UNIXAccountName:UNIXPassword:ID:GIDArray

For group map, MapSvrMBCSMapString has the following format.

 MapType:WindowsAccountName:AuthType:UNIXDomain:UNIXServer:
 UNIXAccountName:GID
  

MapType: A single MBCS character that indicates the type of map from which the mapping was derived. It MUST be one of the following characters.

 Value

 Meaning

'*'

The map is a primary map.

'^'

The map is an advanced map.

'-'

The map is a simple map.

WindowsAccountName: A string of MBCS characters that contains the Windows account name. It MUST be in DOMAIN\NAME format.

AuthType: A single MBCS character that indicates which entity provided the map. AuthType MUST be one of the values in the following table. If the value is AUTH_NIS, the source MUST be a NIS service on the network. If the value is AUTH_FILE, the source SHOULD<2> be from the service-maintained database local to the User Name Mapping Protocol server.

 Value

 Meaning

'0' (AUTH_FILE)

The map was obtained from a service-maintained database local to the User Name Mapping Protocol server. The form of the database is implementation-specific.

'1' (AUTH_NIS)

The map was obtained from a NIS service on the network. NIS is specified in [NIS].

UNIXDomain: A string of MBCS characters that contains the string "PCNFS" if the map was obtained from a service-maintained database, or the NIS server domain to which the account belongs if the map was obtained from a NIS service. If AuthType is equal to AUTH_NIS, this field MUST contain the NIS server domain the account is a member of.

UNIXServer: A string of MBCS characters that contains the string "PCNFS" if the map was obtained from a service-maintained database, or a string that represents the NIS server name to which the account belongs if the map was obtained from a NIS server.

UNIXAccountName: A string of MBCS characters that represents the UNIX account name.

UNIXPassword: A sequence of bytes that represents the password for a user record as returned by a call to the crypt() API that uses the user's cleartext password, as specified in [IEEE1003.1] System Interfaces Volume (XSH). This field is empty when the password is not available or does not apply. The password record MUST NOT contain any MBCS colon characters.

ID: A string of MBCS characters that contains the ID for the UNIX account.

GID: A string of MBCS characters that contains the GID for the UNIX account.

GIDArray: A string of MBCS characters that contains the primary and supplementary GIDs for the UNIX account, with each supplementary GID after the primary GID, and separated by additional colon characters.