DragonFly On-Line Manual Pages

Search: Section:  

CANNASERVER(1M)                                                CANNASERVER(1M)


NAME

       cannaserver - Kana-Kanji conversion server


SYNOPSIS

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


DESCRIPTION

       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
       /tmp/.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.

       /usr/local/share/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(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.

       -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?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.


FILES

       /tmp/.iroha_unix/IROHA[:num]
               Socket. [:num] part is added only when you specify -p.

       /usr/local/share/canna/dic/*/dics.dir
               Dictionary directory

       /etc/hosts.canna
               Access control file

       /var/log/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(1M), cannastat(1), cannacheck(1), cshost(1)

                                                               CANNASERVER(1M)

Search: Section: