Apple Mac OS X Server (Administrator’s Guide) - Manual (Page 188)

188 Chapter 3
Writing a Record Description
A record description identifies the fields in each record you want to import from a character-
delimited file; indicates how records, fields, and values are separated; and describes the
escape character that precedes special characters in a record. Encode the record description
using the following elements in the order specified, separating them using a space:
End-of-record indicator (in hex notation)
Escape character (in hex notation)
Field separator (in hex notation)
Value separator (in hex notation)
Type of accounts in the file (DSRecTypeStandard:Users or DSRecTypeStandard:Groups)
Number of attributes per account
List of attributes
For user accounts, the list of attributes must include the following, although you can omit
UID and PrimaryGroupID if you specify a starting UID and a default primary group ID when
you import the file:
RecordName (the user’s short name)
Password
UniqueID (the UID)
PrimaryGroupID
RealName (the user’s full name)
In addition, you can include
UserShell (the default shell)
NFSHomeDirectory (the path to the user’s home directory on the user’s computer)
Other user attributes, described in Appendix A
For group accounts, the list of attributes must include
RecordName (the group name)
PrimaryGroupID (the group ID)
GroupMembership
In addition, you can include other user attributes, described in Appendix A.
Here is an example of a record description:
0x0A 0x5C 0x3A 0x2C DSRecTypeStandard:Users 7
RecordName Password UniqueID PrimaryGroupID
RealName NFSHomeDirectory UserShell
Here is an example of a record encoded using the description: