1.2 Command-Line Options

‘-d’, ‘--daemon’

Starts the FreeM daemon, exactly one of which must be running at all times in order for FreeM interpreter and fmadm processes to function.

‘-k’, ‘--nofork’

When used with ‘-d’ or ‘--daemon’, causes the FreeM daemon to run instead in the foreground. Useful for debugging.

‘-p’, ‘--pidfile’

When used with ‘-d’ or ‘--daemon’, sets the file in which the PID of the running daemon is stored.

‘-S’, ‘--shmsize’

When used with ‘-d’ or ‘--daemon’, specifies the number of bytes of shared memory FreeM will allocate for the LOCK table, job table, and IPC table. This will determine the maximum number of concurrent FreeM processes and LOCKs available in this environment.

‘-c’, ‘--config’

Specify a configuration file other than $PREFIX/etc/freem.conf.

‘-h’, ‘--help’

Display a help message showing valid FreeM options.

‘-i’, ‘--import’

Causes your UNIX environment variables to be imported into FreeM’s local symbol table.

‘-f’, ‘--filter’

Allows your M routines to be used as UNIX filters.

‘-n <namespace-name>’, ‘--namespace=<namespace-name>’

Selects the FreeM namespace to be entered on startup. Must be defined in ‘/etc/freem.conf’.

‘-r <entryref>’, ‘--routine=<entryref>’

Causes <entryref> to be executed at load, instead of ^%SYS.INIT.

‘--standard=<standard>’

Sets the default FreeM dialect to use for new routine buffers.

Valid values for <standard> are as follows:

M77

Restricts FreeM to use only features specified by the 1977 M standard.

M84

Restricts FreeM to use only features specified by the 1984 M standard.

M90

Restricts FreeM to use only features specified by the 1990 M standard.

M95

Restricts FreeM to use only features specified by the 1995 M standard.

MDS

Restricts FreeM to use only features proposed by the Millennium Draft Standard.

M5

Restricts FreeM to use only features proposed by the upcoming M5 standard.

FREEM, EXTENDED

Removes all standards-based restrictions and allows full access to all FreeM features. This is the default value of $DIALECT.

Please note that FreeM is not entirely standards-compliant, regardless of the value of <standard>.

‘-v’, ‘--version’

Displays FreeM version information.

‘-x <mcode>’, ‘--execute=<mcode>’

Executes M code <mcode> at startup instead of the startup routine.

This document was generated on September 20, 2023 using texi2html 5.0.