NAME¶
cannaserver - Kana-Kanji conversion server
SYNOPSIS¶
cannaserver [-d] [-u userid] [-inet] [-inet6] [-l n] [-syslog]
[-p num] [ddpath]
DESCRIPTION¶
cannaserver(1) provides the Kana-Kanji conversion service. Most commonly this
daemon starts at daemon bootup framework like /etc/rc depending on your
system, so you do not usually start it up manually.
By default,
cannaserver(1) only accepts connections from clients at the same
host where the server is running (via UNIX domain socket). You can make it
accessible from other hosts via TCP by using option -inet (or -inet6). Whether
you use this option or not, you can get access control based on user and host
using /etc/hosts.canna.
cannaserver(1) immediately forks and gets into the background after it starts.
You do not need to use '&' explicitly to make it run in the background.
When it starts,
cannaserver(1) creates the UNIX domain socket
/tmp/.iroha_unix/IROHA[:num] to communicate clients. The socket is deleted
automatically if
cannaserver(1) terminates normally. The socket may exist
while
cannaserver(1) is not running (because, for example,
cannaserver(1)
terminated abnormally). In this case, delete the file manually or you cannot
start it.
/var/lib/canna/dic/*/dics.dir includes the list of dictionaries which are
available to clients. Users (i.e. clients) can choose which to use and specify
them in ~/.canna.
OPTIONS¶
- ddpath
- Specifies the directory that contains dictionaries.
- -inet
- This option lets cannaserver(1) accept connections from remote hosts using
inet domain socket (IPv4). By default, the cannaserver(1) uses only UNIX
domain socket, i.e. only clients in your local machine can connect to the
server.
- -inet6
- Enable IPv6. If this option is used solely, IPv4 access is disabled. If
you want to use IPv4 at the same time, use both -inet and -inet6.
- -l n
- Outputs the cannaserver(1) log to /tmp/canna.log. n (1 to 5) specifies the
log level.
- -d
- Starts cannaserver(1) in debug mode. It is executed as the foreground
process. Log data at log level 5 is output to the standard output.
- -u userid
- Specifies which user cannaserver(1) runs as. By default, cannaserver(1)
runs as the user who started cannaserver(1).
- -syslog
- Outputs the cannaserver(1) log to syslogd(8). If you specify this option,
logs are not output to /var/log/canna/CANNA?msgs.
- -p num
- By this option cannaserver(1) uses the port number 5680 + num. The default
port number is 5680. This option also has an effect on the filename of the
socket and the log file. See below.
FILES¶
- /tmp/.iroha_unix/IROHA[:num]
- Socket. [:num] part is added only when you specify -p.
- /var/lib/canna/dic/*/dics.dir
- Dictionary directory
- /etc/hosts.canna
- Access control file
- /var/log/canna/CANNA?msgs
- Log file. "?" is replaced with num specified with -p, and
defaults to 0 without -p num. Log messages are not output to this
file when -syslog is specified.
SEE ALSO¶
cannakill(1),
cannastat(1),
cannacheck(1),
cshost(1)