The logfile configuration variable

logfile tells Archiveopteryx where to log events, either a file name, stdout or syslog.

If the value starts with /, logfile is considered to be an absolute file name, e.g. /usr/local/archiveopteryx/logfile. Log rotation is supported; Archiveopteryx reopens the file when the logd receives a HUP signal.

If the value is -, Archiveopteryx logs to stdout. This is probably not very useful. Log rotation is not possible.

If the value is syslog/facility, Archiveopteryx logs using the named syslog facility. Note that some syslog implementations have line length restrictions, so really long SQL queries may be truncated in the syslog.

logfile is a string. Its default value is compilation-dependent.

You can see its current value with the command aox show cf logfile.

String syntax

Strings may be written as a single unquoted word or quoted with either single or double quotes, as shown in these three examples:

db-password = single.word
db-password = "rock'n'roll" # a 12-character password
db-password = 'two words, quoted' # a 17-character one

Only single-line strings can be used. Single-word strings may contain the characters a-z, A-Z, 0-9, dot, hyphen and slash.

Spaces are allowed at the start of the line, before and after '=', and after the value. Comments extend from '#' to the end of the line.

Relevant links

• Archiveopteryx 3.0.0
• Archiveopteryx configuration
• The log-level configuration variable