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 naming of console logfiles.

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

glogfilemax

Global setting which specifies the maximum size of console logfiles.

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

gtimestamp

Global setting which specifies the frequency of console logfile timestamps.

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

gro

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

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

grw

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

Corresponds to conserver.cf's ``console->grw'' 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.

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.

access

List of host access blocks.

accessname_hostaccessblocks

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

allowed_hostaccessblock

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

rejected_hostaccessblock

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

trusted_hostaccessblock

List of ``trusted'' hosts for 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

Either the encrypted password for user user of the user group usergroup, or the string ``*passwd*''.

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>