cannaserver






cannaserver − Kana‐Kanji conversion server

cannaserver [−d] [−u userid] [−inet] [−inet6] [−l n]
[−syslog] [−p num] [ddpath]



     cannaserver(1M) 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(1M) 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(1M) 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(1M) creates the UNIX domain
socket /var/run/.iroha_unix/IROHA[:num] to communicate
clients.  The socket is deleted automatically if
cannaserver(1M) terminates normally.  The socket may exist
while cannaserver(1M) is not running (because, for example,
cannaserver(1M) 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.



ddpath      Specifies the directory that contains
            dictionaries.

−inet       This option lets cannaserver(1M) accept
            connections from remote hosts using inet domain
            socket (IPv4).  By default, the cannaserver(1M)
            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(1M) log to
            /tmp/canna.log.  n (1 to 5) specifies the log
            level.









                             ‐2‐


−d          Starts cannaserver(1M) 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(1M) runs as.
            By default, cannaserver(1M) runs as the user who
            started cannaserver(1M).

−syslog     Outputs the cannaserver(1M) 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(1M) 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.



/var/run/.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.



     cannakill(1M), cannastat(1), cannacheck(1), cshost(1)