Installation guide

location
98 Red Hat Directory Server Gateway Customization Guide • April 2005
location
Defines the location choices selectable from the gateway when adding new entries. Each
location parameter represents a branch point in the directory tree below which new
entries can be added.
Format
location handle "friendly_name""dn"
handle. An arbitrary string used by the location-suffix parameter to map a type of
entry to the locations where the entry can be created. For more information, see
“location-suffix,” on page 99.
friendly_name. An arbitrary string that represents the location. This string should
describe the location because the gateway displays this string to users to represent the
location.
dn. The distinguished name (DN) representing this branch point in the directory. If this
value is not terminated with a pound sign, the value specified on the
include parameter
is appended to this value to build the fully qualified distinguished name. If the DN is
terminated with a pound sign (#), the value represented here is assumed to be a fully
qualified distinguished name, and the pound sign is stripped from the distinguished name
before the DN is used by the gateway.
For more information, see “include,” on page 98.
Example
The following example defines an entry creation location in a user directory. This location
corresponds to the Marketing organizational unit, and the remainder of the distinguished
name is built from the value set in the
include parameter:
location marketing "Marketing Organization" "ou=Marketing"
A slightly different example defines the same location but specifies the fully qualified
distinguished name:
location marketing "Marketing Organization" "ou=Marketing,
o=example.com#"
For a more complete example of the location parameter, see “Mapping Locations and
Entry Types,” on page 57.