aprsc 8 "@DATEVERSION@"
.LO 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 language, 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 running 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 chroot 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 happens. 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).