METHODS

Constructors

$class->new( [NAME], OPTIONS )

Create a new system. You can specify a name as first argument, or in the OPTION list. Without a specific name, the organization is used as name.

Option Defined in Default

description

User::Identity::Item

undef

hostname

'localhost'

location

undef

name

User::Identity::Item

<required>

os

undef

parent

User::Identity::Item

undef

password

undef

username

undef

description => STRING
hostname => DOMAIN
The hostname of the described system. It is prefered to use full system names, not abbreviations. For instance, you can better use www.tux.aq than www to avoid confusion.
location => NICKNAME|OBJECT
The NICKNAME of a location which is defined for the same user. You can also specify a User::Identity::Location OBJECT.
name => STRING
os => STRING
The name of the operating system which is run on the server. It is adviced to use the names as used by Perl's $^O variable. See the perlvar man-page for this variable, and perlport for the possible values.
parent => OBJECT
password => STRING
The password to be used to login. This password must be un-encoded: directly usable. Be warned that storing un-encoded passwords is a high security list.
username => STRING
The username to be used to login to this host.

Attributes

$obj->description
See description in User::Identity::Item.
$obj->hostname
$obj->location

Returns the object which describes to which location this system relates. The location may be used to find the name of the organization involved, or to create a signature. If no location is specified, undef is returned.

$obj->name( [NEWNAME] )
See name in User::Identity::Item.
$obj->os
$obj->password
$obj->username

Collections

$obj->add( COLLECTION, ROLE )
See add in User::Identity::Item.
$obj->addCollection( OBJECT | ([TYPE], OPTIONS) )
See addCollection in User::Identity::Item.
$obj->collection( NAME )
See collection in User::Identity::Item.
$obj->find( COLLECTION, ROLE )
See find in User::Identity::Item.
$obj->parent( [PARENT] )
See parent in User::Identity::Item.
$obj->removeCollection( OBJECT|NAME )
See removeCollection in User::Identity::Item.
$obj->type
$class->type
See type in User::Identity::Item.
$obj->user
See user in User::Identity::Item.