xenial (1) cannaserver.1.gz

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)

                                                                                                  CANNASERVER(1)