home | help
aprsc(8)		     System Manager's Manual			aprsc(8)

NAME
     aprsc - An APRS-IS network server

SYNOPSIS
     aprsc  [-t  chrootdir]  [-u setuid_username] [-c config_file_name] [-f] [-n
     logname] [-r log_dir] [-e loglevel_token] [-o logdestination_token] [-h]

DESCRIPTION
     The aprsc (pronounced a-purrs-c) is a plain APRS-IS server intended  to  be
     used  on  the  core and Tier2 APRS-IS servers.  It is written in the C lan-
     guage, and it runs on Linux and Unix servers.

     If you need igate or other radio-interfacing features, the aprsc is not for
     you.

OPTIONS
     The aprsc has following runtime options:

     -t chrootdir
	    Run the aprsc in a chroot(2) subdirectory.	Use also the  -u  option
	    below.

     -u setuid_username
	    When  running the aprsc in chroot(2) subdirectory, it should be run-
	    ning there with a non-privileged user account.  This option  defines
	    that account, which must be found at the system account database.

     -c config_file_name
	    Define explicit configuration file name.  Default is "aprsc.conf" in
	    current directory.

     -f
	    fork(2) the program ro tun in the background.

     -n logname
	    Define  a  name  by which this instance of the aprsc is known in the
	    log.  Useful when you have multiple instances running.

     -r log_dir
	    For file based logging, do it all in given directory.  There  is  no
	    default log directory.

     -e loglevel_token
	    The supported tokens are following with their corresponding priority
	    values EMERG(0), ALERT(1), CRIT(2), ERROR(3), WARNING(4), NOTICE(5),
	    INFO(6),  DEBUG(7).   This	option	defines  a  logging cutoff where
	    events with higher numeric value than the given cutoff  are  dropped
	    internally.  The default cutoff is INFO.

     -o logdestination_token
	    The supported tokens are following: none, stderr, syslog, and file.

LOGGING
     The logging has multiple options:

     none
	    Disable logging completely

     stderr
	    Log  to  stderr of the running users console session Do not use this
	    when runtime option -f is being used.

     syslog
	    Use syslog(3) mechanism to send logging events to system syslogd(8),
	    When running under chroot(2) this may require that	the  syslogd  is
	    configured	to have log event receiving named socket within that ch-
	    root area.

     file
	    The  logging  goes	to  configured	directory  using   file   names:
	    aprsc.log,	and  aprsc.access.log.	 which	autorotate  with up to N
	    older versions, each with M megabytes of size when the rotation hap-
	    pens.  Configuration of N and M is done with aprsc.conf(7).

SEE ALSO
     To be written..

     https://groups.google.com/forum/#!forum/aprsc

AUTHORS
     Matti Aarnio OH2MQK (man page), Heikki Hannikainen OH7LZB (main  software),
     Javier Henderson K4JH (lots of feedback).

			2.1.10-gd72a17c - 2026 August 30		aprsc(8)

home | help