NAME

conserver - An LCFG component to control the conserver console server software

DESCRIPTION

This component constructs conserver's /etc/conserver.cf and /etc/conserver.passwd files from LCFG resources, and controls the conserver daemon.

RESOURCES

The following resources define settings for the conserver.cf file. For more information, see conserver(8), console(1), and conserver.cf(5).

glogfile

Global setting which specifies the default naming of console logfiles.

Corresponds to conserver.cf's ``console->logfile'' parameter.

glogfilemax

Global setting which specifies the default maximum size of console logfiles.

Corresponds to conserver.cf's ``console->logfilemax'' parameter.

gtimestamp

Global setting which specifies the default frequency of console logfile timestamps.

Corresponds to conserver.cf's ``console->timestamp'' parameter.

gro

Global setting which specifies the default read-only console access list.

This should either be ``*'' - meaning all users - or a whitespace-separated list of usernames.

Corresponds to conserver.cf's ``console->ro'' parameter.

grw

Global setting which specifies the default read-write console access list.

This should either be ``*'' - meaning all users - or a whitespace-separated list of usernames.

Corresponds to conserver.cf's ``console->rw'' parameter.

break

List of break definitions, in the range 1 to 9.

delay_break

Delay (in milliseconds) for break number break.

string_break

Break sequence string for break number break.

consoletype

List of console types, used to define ``default'' blocks of the same name for later inclusion in terminal type definitions.

defaultbreak_consoletype

Default break sequence definition for console type consoletype.

terminals

List of terminal type definitions, used to define ``default'' blocks of the same name for later inclusion either in subsequent terminal type definitions, or in console definitions.

ttype_terminal

The type (as defined by conserver.cf(5)) of terminal type terminal.

Normally either device or exec - but see conserver.cf(5) for all possible values.

tinclude_terminal

The ``defaults'' block to be included for terminal type terminal.

This will normally be a ``console type'' defaults block, defined by previous resources.

tmaster_terminal

The master conserver server for terminal type terminal.

tbaud_terminal

The baud rate for terminal type terminal, which must be of type device.

See conserver.cf(5) for possible values.

tparity_terminal

The parity setting for terminal type terminal, which must be of type device.

See conserver.cf(5) for possible values.

exec_terminal

The command to be exec'ed for terminal type terminal, which must be of type exec.

execsubst_terminal

The character substitutions on the exec value for terminal type terminal, which must be of type exec.

host_terminal

The host for terminal type terminal, which must be of type exec.

portbase_terminal

The portbase for terminal type terminal, which must be of type exec.

portinc_terminal

The portinc for terminal type terminal, which must be of type exec.

tro_console

The read-only access list for terminal type terminal.

This should either be ``*'' - meaning all users - or a whitespace-separated list of usernames.

trw_console

The read-write access list for terminal type terminal.

This should either be ``*'' - meaning all users - or a whitespace-separated list of usernames.

consoles

List of all console names in this conserver pool.

cinclude_console

The ``defaults'' block to be included for console console.

This will normally be a ``terminal'' defaults block, defined by previous resources.

cdevice_console

The serial device special filename to be used to access the console console, which must be of type device.

cport_console

The port number to be used to access the console console, which must be of type exec.

cbaud_console

The baud rate for the console console, which must be of type device.

Although a default baud rate will normally already have been specified via the included ``terminal'' defaults block, this resource allows for specific baud rate settings per console, should that be required.

See conserver.cf(5) for possible values.

cparity_console

The parity setting for the console console, which must be of type device.

This will normally already have been specified via the included ``terminal'' defaults block.

See conserver.cf(5) for possible values.

cro_console

The read-only access list for the console console.

This should either be ``*'' - meaning all users - or a whitespace-separated list of usernames.

crw_console

The read-write access list for the console console.

This should either be ``*'' - meaning all users - or a whitespace-separated list of usernames.

access

List of host access blocks.

ainclude_hostaccessblock

The host access block - which much have been previously defined - whose access lists are to be included in hostaccessblock.

accessname_hostaccessblock

Hostname (or IP address) of the host to which the host access block hostaccessblock is to authorize access. If the value ``*'' is used, the access block hostaccessblock will be applied to all conserver hosts.

allowed_hostaccessblock

List of ``allowed'' hosts for the host access block hostaccessblock.

Hosts can be specified using either specific hostnames, IP addresses, of netblocks.

rejected_hostaccessblock

List of ``rejected'' hosts for the host access block hostaccessblock.

Hosts can be specified using either specific hostnames, IP addresses, of netblocks.

trusted_hostaccessblock

List of ``trusted'' hosts for the host access block hostaccessblock.

Hosts can be specified using either specific hostnames, IP addresses, of netblocks.

admin_hostaccessblock

List of users making up the admin list for the host access block hostaccessblock.

limited_hostaccessblock

List of users with limited functionality for the host access block hostaccessblock.

The following resources define settings for the conserver.passwd file. For more information, see conserver(8), console(1), and conserver.passwd(5).

usergroups

List of user group names.

users_usergroup

List of users belonging to user group usergroup.

passwd_usergroup_user

The encrypted password for user user of the user group usergroup. This will be used verbatim in user's entry in the generated conserver.passwd file. If this resource is not specified, then the string ``*passwd*'' will be used instead.

The necessary encrypted password entries can either be copied from the system passwd database, generated by running crypt(3) (via C or perl or some other language that supports it), or generated by any other convenient program which uses crypt(3) (e.g. htpasswd -nd.)

The string ``*passwd*'' indicates that conserver should look up the user's password in the system database, or via PAM (if support for the latter has been compiled into conserver using --with-pam.)

METHODS

start

Starts both this component and the conserver daemon.

stop

Stops both this component and the conserver daemon.

configure

Updates the /etc/conserver.cf and /etc/conserver.passwd files using the above resources, and sends a HUP signal to the conserver daemon, causing it to reconfigure itself without dropping active connections.

SEE ALSO

conserver(8), console(1), conserver.cf(5), conserver.passwd(5)

PLATFORMS

Fedora3, Fedora5, Fedora6, Scientific5

AUTHOR

Ian Durkacz <idurkacz@inf.ed.ac.uk>, Iain Rae <iainr@inf.ed.ac.uk>