CONMAN.CONF man page on Scientific

Printed from http://www.polarhome.com/service/man/?qf=CONMAN.CONF&af=0&tf=2&of=Scientific


CONMAN.CONF(5)		  ConMan: The Console Manager		CONMAN.CONF(5)

NAME
       conman.conf - ConMan daemon configuration file

DESCRIPTION
       The  conman.conf	 configuration	file  is  used to specify the consoles
       being managed by conmand.

       Comments are introduced by a hash sign (#), and continue until the  end
       of  the line.  Blank lines and white-space are ignored.	Directives are
       terminated by a newline, but may span multiple  lines  by  escaping  it
       (i.e.,  immediately  preceding  the newline with a backslash).  Strings
       may be either single-quoted or double-quoted, but they may not  contain
       newlines.  Keywords are case-insensitive.

SERVER DIRECTIVES
       These  directives  begin with the SERVER keyword followed by one of the
       following key/value pairs:

       coredump = (on|off)
	      Specifies whether the daemon should generate a core  dump	 file.
	      This  file  will be created in the current working directory (or
	      '/' when running in the background) unless you  also  set	 core‐
	      dumpdir.	The default is off.

       coredumpdir = "directory"
	      Specifies	 the  directory	 where	the daemon tries to write core
	      dump files.  The default is empty, meaning the  current  working
	      directory (or '/' when running in the background) will be used.

       execpath = "dir1:dir2:dir3..."
	      Specifies	 a  colon-separated  list  of  directories in which to
	      search for external process-based console executables  that  are
	      not defined by an absolute or relative pathname.	The default is
	      empty.

       keepalive = (on|off)
	      Specifies whether	 the  daemon  will  use	 TCP  keep-alives  for
	      detecting dead connections.  The default is on.

       logdir = "directory"
	      Specifies	 a directory prefix for log files that are not defined
	      via an absolute pathname.	  This	affects	 the  server  logfile,
	      global log, and console log directives.

       logfile = "file[,priority]"
	      Specifies	 the  file  to	which log messages are appended if the
	      daemon is not running in the foreground.	This string  undergoes
	      conversion  specifier expansion (cf., CONVERSION SPECIFICATIONS)
	      each time the file is opened.  If an absolute  pathname  is  not
	      given,  the  file's  location  is	 relative to either logdir (if
	      defined) or the current working directory.  Intermediate	direc‐
	      tories  will  be created as needed.  The filename may optionally
	      be followed by a comma and a minimum priority at which  messages
	      will  be	logged.	 Refer to syslog.conf(5) for a list of priori‐
	      ties.  The default priority is info.  If this keyword is used in
	      conjunction  with	 the  syslog keyword, messages will be sent to
	      both locations.

       loopback = (on|off)
	      Specifies whether the daemon will bind its socket to  the	 loop‐
	      back  address,  thereby  only accepting local client connections
	      directed to that address (127.0.0.1).  The default is off.

       pidfile = "file"
	      Specifies the file to which the daemon's PID is written.	Inter‐
	      mediate  directories  will  be  created as needed.  The use of a
	      pidfile is recommended if you want to  use  the  daemon's	 '-k',
	      '-q', or '-r' options.

       port = integer
	      Specifies	 the  port  on which the daemon will listen for client
	      connections.

       resetcmd = "string"
	      Specifies a command string to be	invoked	 by  a	subshell  upon
	      receipt  of  the	client's  "reset"  escape.   Multiple commands
	      within a string may be separated with semicolons.	  This	string
	      undergoes conversion specifier expansion (cf., CONVERSION SPECI‐
	      FICATIONS) and will be invoked multiple times if the  client  is
	      connected to multiple consoles.

       syslog = "facility"
	      Specifies	 that log messages are to be sent to the system logger
	      (syslogd) at the given facility.	Refer to syslog.conf(5) for  a
	      list of facilities.  If this keyword is used in conjunction with
	      the logfile keyword, messages will be sent to both locations.

       tcpwrappers = (on|off)
	      Specifies whether the daemon will use TCP-Wrappers when  accept‐
	      ing  client  connections.	  Support  for	this  feature  must be
	      enabled at compile-time (via  configure's	 "--with-tcp-wrappers"
	      option).	Refer to hosts_access(5) and hosts_options(5) for more
	      details.	The default is off.

       timestamp = integer (m|h|d)
	      Specifies the interval between timestamps written to  the	 indi‐
	      vidual  console  log files.  The interval is an integer that may
	      be followed by a single-character modifier; 'm' for minutes (the
	      default),	 'h'  for  hours,  or  'd' for days.  The default is 0
	      (i.e., no timestamps).

GLOBAL DIRECTIVES
       These directives begin with the GLOBAL keyword followed by one  of  the
       following key/value pairs:

       log = "file"
	      Specifies	 the  default  log file to use for each console direc‐
	      tive.  This  string  undergoes  conversion  specifier  expansion
	      (cf.,  CONVERSION	 SPECIFICATIONS) each time the file is opened;
	      it must contain either '%N' or '%D'.  If an absolute pathname is
	      not  given, the file's location is relative to either logdir (if
	      defined) or the current working directory.  Intermediate	direc‐
	      tories will be created as needed.

       logopts = "(lock|nolock),(sanitize|nosanitize),(timestamp|notimestamp)"
	      Specifies	 global	 options  for  the  console  log files.	 These
	      options can be overridden on a per-console basis	by  specifying
	      the  CONSOLE  logopts  keyword.  Note that options affecting the
	      output of the console's logfile also affect the  output  of  the
	      console's log-replay escape.  The valid logopts include the fol‐
	      lowing:

	      lock or nolock - locked logs are protected with a write lock.

	      sanitize or nosanitize - sanitized  logs	convert	 non-printable
	      characters into 7-bit printable characters.

	      timestamp or notimestamp - timestamped logs prepend each line of
	      console output with a timestamp in "YYYY-MM-DD HH:MM:SS" format.
	      This  timestamp  is generated when the first character following
	      the line break is output.

	      The default is "lock,nosanitize,notimestamp".

       seropts = "bps[,databits[parity[stopbits]]]"
	      Specifies	 global	 options  for  local  serial  devices.	 These
	      options  can  be overridden on a per-console basis by specifying
	      the CONSOLE seropts keyword.

	      bps is an integer specifying the baud rate  in  bits-per-second.
	      If  this	exact value is not supported by the system, it will be
	      rounded down to the next supported value.

	      databits is an integer from 5-8.

	      parity is a single case-insensitive character: 'n' for none, 'o'
	      for odd, and 'e' for even.

	      stopbits is an integer from 1-2.

	      The  default is "9600,8n1" for 9600 bps, 8 data bits, no parity,
	      and 1 stop bit.

       ipmiopts = "U:str,P:str,K:str,C:int,L:str,W:flag"
	      Specifies	 global	 options  for  IPMI  Serial-Over-LAN  devices.
	      These options can be overridden on a per-console basis by speci‐
	      fying the CONSOLE IPMIOPTS  keyword.   This  directive  is  only
	      available if configured using the "--with-freeipmi" option.

	      The  IPMIOPTS  string  is parsed into comma-delimited substrings
	      where each substring is of the form "X:VALUE".  "X" is a single-
	      character	 case-insensitive  key specifying the option type, and
	      "VALUE" is its corresponding value.  The IPMI  default  will  be
	      used  if	either "VALUE" is omitted from the substring ("X:") or
	      the substring  is	 omitted  altogether.	Note  that  since  the
	      IPMIOPTS	string is delimited by commas, substring values cannot
	      contain commas.

	      The valid IPMIOPTS substrings  include  the  following  (in  any
	      order):

	      U:username  - a string of at most 16 bytes for the username with
	      which to authenticate to the BMCs serving the remote consoles.

	      P:password - a string of at most 20 bytes for the password  with
	      which to authenticate to the BMCs serving the remote consoles.

	      K:K_g  - a string of at most 20 bytes for the K_g key with which
	      to authenticate to the BMCs serving the remote consoles.

	      C:cipher_suite - an integer for the IPMI cipher suite ID.	 Refer
	      to ipmiconsole(8) for a list of currently supported IDs.

	      L:privilege_level - the string "user", "op", or "admin".

	      W:workaround_flag	 - a string or integer for an IPMI workaround.
	      Refer to ipmiconsole(8) for a list of currently supported flags.
	      This  substring  may  be repeated to specify multiple workaround
	      flags.

	      Both the password and K_g values	can  be	 specified  in	either
	      ASCII  or	 hexadecimal;  in  the	latter case, the string should
	      begin with "0x" and contain at most 40  hexadecimal  digits.   A
	      K_g key entered in hexadecimal may contain embedded null charac‐
	      ters, but any characters following the first null	 character  in
	      the password key will be ignored.

CONSOLE DIRECTIVES
       This  directive defines an individual console being managed by the dae‐
       mon.  The CONSOLE keyword is followed by one or more of	the  following
       key/value pairs:

       name = "string"
	      Specifies	 the  name  used  by  clients to refer to the console.
	      This keyword is required.

       dev = "string"
	      Specifies the type and location of the device.  This keyword  is
	      required.

	      A local serial port connection is defined by the pathname of the
	      character device file.

	      A remote terminal server connection using the telnet protocol is
	      defined  by  the	"host:port"  format  (where host is the remote
	      hostname or IPv4 address, and port is the remote port number).

	      An external process-based connection is  defined	by  the	 "path
	      args"  format  (where  path  is  the  pathname  to an executable
	      file/script, and any additional args are	space-delimited);  the
	      /usr/lib/conman/exec directory contains scripts for various con‐
	      sole types.

	      A	 local	Unix  domain  socket  connection  is  defined  by  the
	      "unix:path"  format  (where  "unix:"  is	the  literal character
	      string prefix and path is the pathname of the local socket).

	      An IPMI Serial-Over-LAN connection is defined by the "ipmi:host"
	      format  (where "ipmi:" is the literal string and host is a host‐
	      name or IPv4 address).

	      The '%N' character sequence will	be  replaced  by  the  console
	      name.

       log = "file"
	      Specifies	 the file where console output is logged.  This string
	      undergoes conversion specifier expansion (cf., CONVERSION SPECI‐
	      FICATIONS)  each	time the file is opened.  If an absolute path‐
	      name is not given, the file's location  is  relative  to	either
	      logdir  (if defined) or the current working directory.  Interme‐
	      diate directories will be	 created  as  needed.	An  empty  log
	      string  (i.e.,  log="")  disables logging, overriding the global
	      log name.

       logopts = "string"
	      This keyword is optional (cf., GLOBAL DIRECTIVES).

       seropts = "string"
	      This keyword is optional (cf., GLOBAL DIRECTIVES).

       ipmiopts = "string"
	      This keyword is optional (cf., GLOBAL DIRECTIVES).

CONVERSION SPECIFICATIONS
       A conversion specifier is a two-character sequence beginning with a '%'
       character.   The second character in the sequence specifies the type of
       conversion to be applied.  The following specifiers are supported:

       %N     The console name (from the name string).

       %D     The console device basename (from the dev string), with  leading
	      directory components removed.

       %P     The daemon's process identifier.

       %Y     The year as a 4-digit number with the century.

       %y     The year as a 2-digit number without the century.

       %m     The month as a 2-digit number (01-12).

       %d     The day of the month as a 2-digit number (01-31).

       %H     The hour as a 2-digit number using a 24-hour clock (00-23).

       %M     The minute as a 2-digit number (00-59).

       %S     The seconds as a 2-digit number (00-61).

       %s     The number of seconds since the Epoch.

       %%     A literal '%' character.

       The  console  name  (%N)	 and device (%D) specifiers are "sanitized" in
       that non-printable characters and the forward-slash (/)	character  are
       replaced with underscores.

FILES
       /etc/conman.conf

AUTHOR
       Chris Dunlap <cdunlap@llnl.gov>

COPYRIGHT
       Copyright (C) 2007-2011 Lawrence Livermore National Security, LLC.
       Copyright (C) 2001-2007 The Regents of the University of California.

       ConMan is free software: you can redistribute it and/or modify it under
       the terms of the GNU General Public License as published	 by  the  Free
       Software	 Foundation,  either  version  3  of  the License, or (at your
       option) any later version.

SEE ALSO
       conman(1), conmand(8).

       http://conman.googlecode.com/

conman-0.2.7			  2011-04-21			CONMAN.CONF(5)
[top]

List of man pages available for Scientific

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net