conmand(8)

1CONMAND(8)                ConMan: The Console Manager               CONMAND(8)
2
3
4

NAME

6       conmand - ConMan daemon
7
8

SYNOPSIS

10       conmand [OPTION]...
11
12

DESCRIPTION

14       conmand  is the daemon responsible for managing consoles defined by its
15       configuration file as well as listening for connections from clients.
16
17

OPTIONS

19       -c file
20              Specify a configuration file, overriding  the  default  location
21              [/etc/conman.conf].
22
23       -F     Run the daemon in the foreground.
24
25       -h     Display a summary of the command-line options.
26
27       -k     Send a SIGTERM to the conmand process associated with the speci‐
28              fied configuration, thereby killing the daemon.   Returns  0  if
29              the daemon was successfully signaled; otherwise, returns 1.
30
31       -L     Display license information.
32
33       -p port
34              Specify the port on which conmand will listen for clients, over‐
35              riding both the default port [7890] and the  port  specified  in
36              the configuration file.
37
38       -P file
39              Specify  the  PID  file for storing the daemon's PID, overriding
40              the "server pidfile" directive in the configuration file.
41
42       -q     Displays the PID of the  conmand  process  associated  with  the
43              specified  configuration if it appears active.  Returns 0 if the
44              configuration appears active; otherwise, returns 1.
45
46       -r     Send a SIGHUP to the conmand process associated with the  speci‐
47              fied  configuration,  thereby  re-opening both that daemon's log
48              file and individual console log files.  Returns 0 if the  daemon
49              was successfully signaled; otherwise, returns 1.
50
51       -v     Enable verbose mode.
52
53       -V     Display version information.
54
55       -z     Truncate  both  the daemon's log file and individual console log
56              files at start-up.
57
58

SIGNALS

60       SIGHUP      Close and re-open both the daemon's log file and the  indi‐
61                   vidual  console  log  files.   Conversion specifiers within
62                   filenames will be re-evaluated.  This is useful for  logro‐
63                   tate configurations.
64
65       SIGTERM     Terminate the daemon.
66
67

SECURITY

69       Connections  to  the  server  are not authenticated, and communications
70       between client and server are not encrypted.  Until this  is  addressed
71       in  a future release, the recommendation is to bind the server's listen
72       socket to the loopback address (by specifying "server  loopback=on"  in
73       conman.conf) and restrict access to the server host.
74
75

NOTES

77       Log  messages  are sent to standard-error until after the configuration
78       file has been read, at which time future messages are discarded  unless
79       either  the  logfile  or  syslog  keyword has been specified (cf., con‐
80       man.conf(5)).
81
82       If the configuration file is modified while the daemon is running and a
83       pidfile  was not originally specified, the '-k' and '-r' options may be
84       unable to identify the daemon process;  consequently,  the  appropriate
85       signal may need to be sent to the daemon manually.
86
87       The number of consoles that can be simultaneously managed is limited by
88       the maximum number of file descriptors a process can  have  open.   The
89       daemon  sets its "nofile" soft limit to the maximum/hard limit.  If you
90       are encountering "too many open files" errors, you may need to increase
91       the "nofile" hard limit.
92
93

AUTHOR

95       Chris Dunlap <cdunlap@llnl.gov>
96
97

COPYRIGHT

99       Copyright (C) 2007-2017 Lawrence Livermore National Security, LLC.
100       Copyright (C) 2001-2007 The Regents of the University of California.
101
102

LICENSE

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