beautypg.com

Using character-delimited files – Apple Mac OS X Server (version 10.2.3 or later) User Manual

Page 191

background image

Users and Groups

191

Using Character-Delimited Files

You can create a character-delimited file by using Workgroup Manager or dsimportexport to
export accounts in NetInfo or LDAPv3 directory domains into a file. You can also create a
character-delimited file by hand or by using a database or spreadsheet application.

The first record in the file must characterize the format of each account in the file. There are
three options:

m Write a full record description.

m Use the shorthand “StandardUserRecord.”

m Use the shorthand “StandardGroupRecord.”

The other records in the file describe user or group accounts, encoded in the format
described by the first record.

Any line of a character-delimited file that begins with “#” is ignored during importing.

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)

LL0395.Book Page 191 Wednesday, November 20, 2002 11:44 AM