home | help
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 back-
     ground.

     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 can-
     not 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 can-
		 naserver(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 dis-
		 abled.  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, can-
		 naserver(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)

home | help