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

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)