cannaserver



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  com-
       monly  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.


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   can-
                   naserver(1M).

       -syslog     Outputs the cannaserver(1M) log to syslogd(8). If you spec-
                   ify   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.


FILES

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


SEE ALSO

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



                                                               CANNASERVER(1M)

Man(1) output converted with man2html