NAME

       jamnntpd - An NNTP server that allows newsreaders to access a JAM messagebase.

SYNOPSIS

       jamnntpd [options]

DESCRIPTION

       JamNNTPd is an attempt to merge FTN/Fidonet technology with standard Usenet newsreaders. Basically, it is
       an NNTP server that allows newsreaders to access a JAM messagebase.

       The behaviour of JamNNTPd can be configured using the configuration options specified below. These can be
       given to JamNNTPd in two ways:

       1) As commandline arguments

       2)  In  a  configuration file (see -config command). The preceding dash (-) is optional when an option is
       given in a file, it will be added if missing. A configuration file  with  the  default  settings  can  be
       created with the -create option.

       If  JamNNTPd is run without any commandline arguments at all, it will attempt to read options from a file
       called "jamnntpd.config" if present. Under Linux, JamNNTPd   will  look  for  this  file  in  the  "/etc"
       directory and under Windows in the current directory.

       It  is  not  necessary  to specify any configuration options at all unless when fine-tuning JamNNTPd, the
       default have been designed to be sensible.

OPTIONS

       General options:

       -port <port> or -p <port>
              Set the port where JamNNTPd listens for connections. The default is 5000.

       -max <maxconn> or -m <maxconn>
               The maximum allowed number of connections at one time. The default is 5.

       -groups <groupsfile> or -g <groupsfile>
              -allow <allowfile> or -a <allowfile> -users <usersfile> or -u <usersfile> -xlat <xlatfile>  or  -x
              <xlatfile> Use those to override the default locations of the config files.

       -logfile <logfile> or -l <logfile>
              Use this to override the default location of the log file.

       -noecholog
              Disables echoing of log messages to the console window.

       -debug If  this  option  is  used,  JamNNTPd will print all sent and received text to the console window.
              Useful for testing

       Options for displaying messages:

       -readorigin
              Get address from the Origin line instead of the OADDRESS field of the  JAM  message  header.  This
              option makes JamNNTPd slower, but may be useful if your tosser does not set the OADDRESS field.

       -noencode
              JamNNTPd  by  default  MIME-encodes  headers  with  non-ascii  characters. If you use this option,
              JamNNTPd will instead send the headers as plain 8-bit text.

       -strictnetmail
              Makes JamNNTPd use strict article counters for netmail messages. Normally  JamNNTPd  uses  article
              counters  that  include  all  messages,  not  only  those  that  the user is allowed to read. That
              behaviour is much faster, but may cause your newsreader to indicate the presence of  new  messages
              in the netmail area even when there are only messages for other users. Using this option will make
              JamNNTPd  slower,  but  speed  seems  to  be  acceptable  for  small netmail areas with up to 1000
              messages. Users will never be allowed to actually read netmail messages of other users  even  when
              this option is not used.

       -def_flowed onoff
              -def_showto  onoff  Sets the default of the flowed and showto settings (if no default is specified
              on the commandline, both will be on by default)

              flowed: If flowed is on, JamNNTPd will use format=flowed (section 6.5),  otherwise  it  will  wrap
              long lines to a fixed width.

              showto:  Since there is no receiver for news messages, JamNNTPd can display the receiver name as a
              part of the sender name. With this option, this behaviour can be turned on or off.

              These can be modified by the user by logging in with parameters (section 4.4)

       Options for posting messages:

       -nostripre
              JamNNTPd normally strips "Re:" from subject lines of followups. Use this option  if  you  want  to
              retain the "Re:".

       -notearline
              JamNNTPd  normally  puts  the  information from the X-Newsreader or User-Agent header field in the
              tearline of posted messages. This option disables this behaviour and leaves the tearline blank.

       -noreplyaddr
              JamNNTPd normally adds a REPLYADDR kludge  with  the  e-mail  address  of  the  sender  in  posted
              messages.  Use  this  option  if  you  don't  want REPLYADDR  kludges. See also see section 6.4 in
              ReadMe.txt.

       -notzutc
              JamNNTPd normally writes the timezone into a TZUTC kludge when a message is posted.  You  can  use
              this option if you don't want to create TZUTC kludges.

       -nocancel
              Disallows  the  cancelling  (deleting) of messages by the users. If allowed, users can only cancel
              messages from one of their "realnames" and only if the message has not yet been sent.

       -smartquote
              The quoting style of most newsreaders is different  from  traditional  fidonet  software.  If  you
              enable this option, JamNNTPd will try to change any quoted lines to fidonet style. This means that
              it  will  try  to insert the initials of the person you reply to before the '>' character and also
              that it will try to compound multiple generations of quotes, i.e. "AA> BB>" will be  changed  into
              "BB>>".

              Reformatting  quotes in this way means that the user who posts a message will no longer have final
              say over the final content of the message since it will be changed after he or  she  sends  it  to
              JamNNTPd.  Since this in principle is a bad thing even if quoted text will look a lot better after
              reformatting, this option is turned off by default.

       -origin <origin>
              Normally JamNNTPd uses the text found in the Organization header line as the Origin line  text  in
              posted messages. You can use this switch to override the Organization line and set your own origin
              for all posted messages.

       -guestsuffix <suffix>
              If  desired,  JamNNTPd  can  add  a  suffix  to posts from unauthenticated users. To activate that
              feature, specify the suffix here.

              Example:  -guestsuffix " [GUEST]".

       -echomailjam <echomail.jam>
              If you specify a filename here, JamNNTPd will write a line to this file with the  messagebase  and
              message  number  for  each  message  that  is  posted.   The  file follows the ECHOMAIL.JAM format
              supported by some tossers.

       Options for configuration files:

       -config <configfile>
              Read options from the specified configuration file.

       -create <configfile>
              Create a configuration file with the default settings.

SEE ALSO

       The ReadMe.txt file and makechs(1).

AUTHOR

       jamnntpd was written by Johan Billing <billing@df.lth.se>.

       This manual page was written by Robert James Clay <jame@rocasa.us>, for the Debian project  (but  may  be
       used by others).

                                                  May 18, 2013                                       JAMNNTPD(1)