Skip to content

Useful config settings

Ken Haase edited this page Jun 11, 2019 · 1 revision

Useful CONFIG settings

Version info

FDVERSION
Get the FramerD version string
FDREVISION
Get the FramerD revision identifier
FDBRANCH
Get the FramerD branch name
FDMAJOR
Get the FramerD major version number
U8VERSION
Get the libu8 version string
U8REVISION
Get the libu8 revision identifier
U8MAJOR
Get the libu8 major version number

Logging

LOGLEVEL
Required priority for messages to be displayed
LOGLEVEL
Required priority for messages to be displayed
LOGLEVEL:STDOUT
Required priority for messages to be displayed on stdout
LOGLEVEL:STDERR
Required priority for messages to be displayed on stderr
LOGINDENT
String for indenting multi-line log messages
LOGPREFIX
Prefix for log messages (default '[')
LOGSUFFIX
Suffix for log messages (default ']\n')
LOGDATE
Whether to show the date in log messages
LOGPROCINFO
Whether to show PID/appid info in messages
LOGTHREADINFO
Whether to show thread id info in messages
LOGELAPSED
Whether to show elapsed time in messages
LOG:DATE
Whether to show the date in log messages
LOG:ELAPSED
Whether to show elapsed time in messages
LOG:THREADID
Whether to show thread id info in messages
THREADDEBUG
Whether to output thread debug messages
THREADLOGLEVEL
Loglevel to use for thread debug messages
LOGFN
the default log function
LOGFNS
additional log functions
REQ:LOGLEVEL
whether to use FramerD per-request logging
REQ:LOGONLY
only use per-request logging (when available) for loglevels >= this

Implementation limits

FIXMAX
The maximum fixnum value
MAXFIX
The maximum fixnum value
FIXMIN
The minimum fixnum value
MINFIX
The minimum fixnum value
UINTMAX
Maximum value for an underlying unsigned INT
INTMAX
Maximum value for an underlying unsigned INT
INTMIN
Maximum value for an underlying unsigned INT

Process information/limits

PID
system process ID (read-only)
PPID
parent's process ID (read-only)
RUNUSER
Set the user ID for this process
RUNGROUP
Set the group ID for this process
RUNBASE
Path prefix for program state files
STDOUT
Redirect standard output to file
STDERR
Redirect standard output to file
STDIN
Redirect standard input to file
PIDFILE
Write PID to file, delete on exit
APPID
application ID used in messages and SESSIONID
ARGV
the vector of args (before parsing) to the application (no configs)
RAWARGS
the vector of args (before parsing) to the application (no configs)
CMDARGS
the vector of parsed args to the application (no configs)
ARGS
the vector of parsed args to the application (no configs)
STRINGARGS
the vector of args (before parsing) to the application (no configs)
CONFIGARGS
config arguments passed to the application (unparsed)
EXENAME
the vector of args (before parsing) to the application (no configs)
MAXCPU
Max CPU execution time limit
MAXRSS
Max resident set (RSS) size
MAXCORE
Max core dump size
MAXNPROC
Max number of subprocesses
MAXFILES
Max number of open file descriptors
MAXSTACK
Max stack depth
CORELIMIT
Set core size limit
CPULIMIT
Set cpu time limit (in seconds)
RSSLIMIT
Set resident memory limit
VMEMLIMIT
Set total VMEM limit
HEAPLIMIT
Set total heap (DATA segment) limit
STACKLIMIT
Size of the stack (in bytes or as a factor of the current size)

AWS configuration information

AWS:ACCOUNT
()
AWS:REGION
()
AWS:KEY
()
AWS:SECRET
()
AWS:TEMPLATES
()
AWS:CONFIG
()
CURLCACHE:DEFAULT
()
AWS:V4ERR
()
AWS:CURLCACHE
()

Configuration settings for the OTIMIZE module

OPTLEVEL
()
OPTIMIZE:LEVEL
()
OPTIMIZE:FCNREFS
()
OPTIMIZE:OPCODES
()
OPTIMIZE:BINDOPS
()
OPTIMIZE:SUBSTS
()
OPTIMIZE:LEXREFS
()
OPTIMIZE:REWRITE
()
OPTIMIZE:ALIASFNS
()
OPTIMIZE:STATICFNS
()
OPTIMIZE:STATICPRIMS
()
OPTIMIZE:PERSIST
()
OPTIMIZE:KEEPSOURCE
()
OPTWARN
()
OPTIMIZE:CHECKUSAGE
()

Thread related settings

ALLTHREADS
All active LISP threads
THREAD:BACKTRACE
Whether errors in threads print out full backtraces
THREAD:LOGLEVEL
The log level to use for thread-related events
THREAD:LOGEXIT
Whether to log the normal exit values of threads

Module loading settings

LOADPATH
Directories/URIs to search for modules (not sandbox)
SAFELOADPATH
Directories/URIs to search for sandbox modules
UPDATEMODULES
Modules to update automatically on UPDATEMODULES
LIBSCM
The location for bundled modules (prioritized before loadpath)
DLOAD:PATH
Add directories for dynamic compiled modules
DLOAD:TRACE
Whether to announce the loading of dynamic modules
CACHELEVEL
Sets a level of time/memory tradeoff [0-3], default 1
MODULE
Specify modules to be used by the default live environment
CONFIGDATA
Directory for looking up config entries
CWD
Get/set the current working directory
TRACECONFIG
whether to trace configuration
QUIET
Whether to minimize console output
UTF8WARN
warn on bad UTF-8 sequences
UTF8ERR
fail (error) on bad UTF-8 sequences
RANDOMSEED
random seed used for stochastic operations
CHECKUTF8
check that strings are valid UTF-8 on creation
LOGCMD
Whether to display command line args on entry and exit
SESSIONID
unique session identifier
FASTEXIT
whether to recycle session state on exit
EXIT:FAST
whether to recycle session state on exit
LOGDIR
Root FramerD logging directories
SHAREDIR
Shared config/data directory for FramerD
DATADIR
Data directory for FramerD
SOURCES
Registered source files
U8:MMAPTHRESH
Size at which u8_big_alloc starts using MMAP
HASH:BIGTHRESH
Number of buckets at which hashtables use bigalloc
BUFIO:BIGTHRESH
Size of binary buffers to use bigalloc
ATEXIT
Procedures to call on exit
EXITING
Whether this process is exiting
UMASK
The UMASK of the current process
GROUP
The default group for the ucrrent process
MAXCHARS
Max number of chars to show in strings
MAXELTS
Max number of elements to show in vectors/lists/choices, etc
NUMVEC:SHOWMAX
Max number of elements to show in numeric vectors
PACKETFMT
How to dump packets to ASCII (16 = hex,64 = base64,dflt = ascii-ish)
OIDS:NUMERIC
Whether to use custom formatting for OIDs
PPRINT:MAXCHARS
Maximum number of characters when pprinting strings
PPRINT:MAXBYTE
Maximum number of bytes when pprinting packets
PPRINT:MAXELTS
Maximum number of elements when pprinting sequences or choices
PPRINT:MAXDEPTH
Maximum depth for recursive printing
PPRINT:LISTMAX
Maximum number of elements when pprinting lists
PPRINT:VECTORMAX
Maximum number of elements when pprinting vectors
PPRINT:CHOICEMAX
Maximum number of elements when pprinting choices
PPRINT:KEYSMAX
Maximum number of keys when pprinting tables
PPRINT:INDENTS
PPRINT indentation rules
LOCALMODULES
value of LOCAL_MODULES
LOCALSAFEMODULES
value of LOCAL_SAFE_MODULES
INSTALLEDMODULES
value of INSTALLED_MODULES
INSTALLEDSAFEMODULES
value of INSTALLED_SAFE_MODULES
SHAREDMODULES
value of SHARED_MODULES
SHAREDSAFEMODULES
value of SHARED_SAFE_MODULES
BUILTINMODULES
value of BUILTIN_MODULES
BUILTINSAFEMODULES
value of BUILTIN_SAFE_MODULES
UNPACKAGEDIR
value of UNPACKAGE_DIR
USEDTBLOCK
Use the DTBLOCK dtype code when appropriate
CHECKDTSIZE
whether to check returned and real dtype sizes
TIDYSTACKS
Whether to include raw ops in stacks when source is available
PROFILING
Whether to profile function applications by default
PROFILED
Functions declared for profiling
FCNID:LEAK
Leak values stored behind function IDs, to avoid use after free due to dangling references
BUILDINFO
Information about compile-time features
STREAMS:LOGLEVEL
LOGLEVEL for binary streams
BACKGROUND
indexes in the default search background
DEFAULTPOOL
Default location for new OID allocation
TEMPINDEX:SIZE
default size for tempindex caches
ACIDFILES
Maintain acidity of individual file pools and indexes
DRIVERBUFSIZE
The size of file streams used in database files
ASYNC
Assume asynchronous DType servers
OIDDISPLAY
Default oid display level [0-3]
DBLOGLEVEL
Default log level for database messages
PREFETCH
Whether to prefetch for large operations
POOLS
pools used for OID resolution
INDEXES
indexes opened
DBCONNRESERVE
Number of connections to keep for each DB server
DBCONNCAP
Max number of connections (default) for each DB server
DBCONNINIT
Number of connections to initially create for each DB server
LOOKUPOID
Functions and slotids for lookup up objects by name (@?name)
ONSAVE
Functions to run when saving databases
BIGPOOL:LOGLEVEL
The default loglevel for bigpools
FILEINDEX:SIZE
The default size for file indexes
HASHINDEX:SIZE
The default size for hash indexes
HASHINDEX:LOGLEVEL
The default loglevel for hashindexs
TAILCALL
Enable/disable tail recursion in the Scheme evaluator. This may cause various source packages to break in some or all cases.
BUGDIR
Save exceptions to this directory
GPROFILE
Set filename for the Google CPU profiler
LOGTESTS
Whether to log failed tests, rather than treating them as errors
FAILEDTESTS
All failed tests
DLOADPATH
Add directories for dynamic compiled modules
LOCKEXPORTS
Lock the exports of modules when loaded
LOCKMODULES
Lock bindings of source modules after they are loaded
STATICMODULES
Convert function values in a module into static values
LOADMODULE
Specify modules to be loaded
LOADMODULE:SANDBOX
Whether LOADMODULE loads from the sandbox
CONFIG
Add a CONFIG file/URI to process
DEFAULTS
Add a CONFIG file/URI to process as defaults
OPTCONFIG
Add an optional CONFIG file/URI to process
TRACELOAD
Trace file load starts and ends
TRACELOADCONFIG
Trace config file loading
TRACELOADEVAL
Trace expressions while loading files
APPMODS
Which modules to load into the application environment
APPLOAD
Which files to load into the application environment
APPEVAL
Which functions/forms to execute to set up the application environment
SQLEXEC
whether direct execution of SQL strings is allowed
TEMPROOT
Template for generating temporary directory names
TEMPDIRS
Declared temporary directories to be deleted on exit
KEEPDIRS
Temporary directories to not be deleted on exit
KEEPTEMP
Temporary directories to not be deleted on exit
STACKDUMP
File to store stackdump information on errors
LIVELOAD
Files to be reloaded as they change
SERVEPOOLS
OID pools to be served
PRIMARYPOOL
OID pool where new OIDs are allocated
SERVEINDEXES
indexes to be served
DBSERV:LOGLEVEL
the dbserv loglevel
LOCKSFILE
location of the persistent locks file
BROWSEINFO
How to display OIDs for browsing in HTML/XML
BROWSEOIDURI
Default anchor URI for OID references
BROWSEOIDCLASS
Default HTML CSS class for OID references
ERRORSTYLESHEET
Default style sheet for web errors
MAILHOST
SMTP host
MAILDOMAIN
SMTP default domain
MAILFROM
SMTP default from
CACHEMARKUP
Whether to cache markup generated from unparsing XML
CGIPREP
Functions to execute between parsing and responding to a CGI request
XSENDFILE
Header for using the web server's X-SENDFILE functionality
XREDIRECT
Header for using the web server's X-REDIRECT functionality
LOGCGI
Whether to log CGI bindings passed to FramerD
QUERYONPOST
Whether to parse REST query args when there is POST data
CGI:PROTECT
Fields to avoid binding directly for CGI requests
CURL:LOGLEVEL
Loglevel for debugging CURL calls
CURL:USERAGENT
What CURL should use as the default user agent string
CURL:REDIRECTS
Maximum number of redirects to allow
SHOWTIME
Threshold for displaying execution time
PROMPT
Eval prompt (within #||#s)
DBGMAXCHARS
Max number of string characters to display in debug message
DBGMAXELTS
Max number of sequence/choice elements to display in debug message
STARTUPTIME
Report startup times when longer than N seconds
CONSOLEWIDTH
Number of characters available for pretty-printing console output
SHOWELTS
Number of elements to initially show in displaying results
BUGDUMPS
Where to create directories for saving backtraces
BUGURLBASE
The base URL for referencing HTML backtraces
BUGBROWSE
The command to use to open saved backtraces
HTMLDUMPS
Whether to dump HTML versions of backtraces
LISPDUMPS
Whether to dump LISP object versions of backtraces
DTYPEDUMPS
Whether to dump binary DTYPE versions of backtraces
TEXTDUMPS
Whether to plaintext versions of backtraces
SAVEBACKTRACE
Whether to always save backtraces in the history
SHOWBACKTRACE
Whether to always output backtraces to stderr
DOTLOAD
Whether load .fdconsole or other dot files
BUGLOG
Where to dump console errors
LOADMOD
Which modules to load into the application environment
LOADFILE
Which files to load into the application environment
INITS
Which functions/forms to execute to set up the application environment
STOPFILE
File to wait to exist before starting
LOGDELUGE
()
LOGDETAIL
()
LOGDEBUG
()
LOGINFO
()
LOGNOTICE
()
LOGWARN
()
LOGERR
()
LOGCRIT
()
LOGALERT
()
LOGPANIC
()
CONFIG:TRUE
()
CONFIG:FALSE
()
LOGCTL
()
CURLCACHE
()
MIME:CHARSET
()
MIME:DEFAULT
()
MELTPOINT
()
MT:THREADCOUNT
()
MTT:THREADCOUNT
()
MTVERBOSE
()
S3ROOT
()
S3SCHEME
()
AWS:S3ERRS
()
S3PATHSTYLE
()
S3:RETRIES
()
S3:RETRYWAIT
()
S3WEBSITES
()
S3CACHE
()
S3:HEADCACHE
()
AWS:S3URLMAP
()
AWS:S3DISKMAP
()
GP:URLSUBST
()
GPATH:HANDLERS
()
GPATH:DIRMODE
()
GPATH:GUESSENCODING
()
PARSETIME/USAFMT
()
EDITLINE
Whether to use EDITLINE for the console