HostAssignedUsers Transformer
[Data Transformers]

SYNOPSYS

Transformer Name:

HostAssignedUsers

DESCRIPTION

The HostAssignedUsers transformer expects a list of host and user objects as the input set. It then selects the host object(s) either associated with the host the transformer is running on or with the host names passed down using the Hostname option and extracts a list of users from their sfiassigneduser attribute. In a second pass the transformer selects all the user objects of the input set that were referred to in the sfiassigneduser attribute(s) and copies them to the result set. Thus, the result set contains user objects for all the users that where assigned to the target host.

Options

Hostname

A comma-separated list of names of hosts that should be respected. If no Hostname option is set, then the name and aliases of the current host are used.

SYNTAX

Besides listing user logins, the sfiassigneduser attribute may also include

• references to groups - all members of the group will then be included in the list
• attribute replacements - for instance replace login shell or make account being locked on the target host
• all users

The syntax of each entry therefore is one of

  login
  login:options
  groupname:group
  groupname:group;options
  all:all
  all:all;options

where options is a semi-colon separated list of one or multiple options.

Note:

If a group is used in the assigned user list the respective group must be a member of the transformers input set, otherwise the entry will be ignored.

The special name all:all means all users.

The entries are handled in order. If a user is matched by multiple entries, only the first entry applies to this user.

Entry Options

Currently, only attribute replacements are accepted as options. Each of these replacement options starts with the name of the attribute that should get its contents replaced, followed by a "=" followed by an expression evaluating to the value the attribute should have after replacement. The expression may refer to other attributes of the respective user object. See also the examples below.

Examples

  john
  peter:loginshell=/bin/true
  tom:userpassword={x-locked}
  users:group;homedirectory=/home/u/$uid;loginshell=/bin/true

---