8.7.3 autogen-options options

All other options. These options are mostly just passed throug to autogen. The one exception is --override-tpl which replaces the default template in the output definitions. It does not get passed through on the command line.

templ-dirs option (-L).

This is the “search for templates in ‘dir’” option. This option takes a string argument ‘DIR’.

This option has some usage constraints. It:

• may appear an unlimited number of times.

Pass-through AutoGen argument

override-tpl option (-T).

This is the “use ‘tpl-file’ for the template” option. This option takes a string argument ‘TPL-FILE’. Pass-through AutoGen argument

lib-template option (-l).

This is the “load autogen macros from ‘tpl-file’” option. This option takes a string argument ‘TPL-FILE’.

This option has some usage constraints. It:

• may appear an unlimited number of times.

Pass-through AutoGen argument

NOTE: THIS OPTION IS DEPRECATED

definitions option.

This is the “read definitions from ‘file’” option. This option takes a string argument ‘FILE’. Pass-through AutoGen argument

shell option.

This is the “name or path name of shell to use” option. This option takes a string argument ‘shell’. Pass-through AutoGen argument

no-fmemopen option (-m).

This is the “do not use in-mem streams” option. Pass-through AutoGen argument

equate option.

This is the “characters considered equivalent” option. This option takes a string argument ‘char-list’. Pass-through AutoGen argument

base-name option (-b).

This is the “specify name as the base name for output” option. This option takes a string argument ‘NAME’. Pass-through AutoGen argument

source-time option.

This is the “set mod times to latest source” option. Pass-through AutoGen argument

writable option.

This is the “allow output files to be writable” option.

This option has some usage constraints. It:

• can be disabled with –not-writable.

Pass-through AutoGen argument

loop-limit option.

This is the “limit on increment loops” option. This option takes a number argument ‘lim’. Pass-through AutoGen argument

timeout option (-t).

This is the “limit server shell operations to seconds” option. This option takes a number argument ‘SECONDS’. Pass-through AutoGen argument

trace option.

This is the “tracing level of detail” option. This option takes a keyword argument ‘level’.

This option has some usage constraints. It:

• This option takes a keyword as its argument. The argument sets an enumeration value that can be tested by comparing the option value macro (OPT_VALUE_TRACE). The available keywords are:

  nothing debug-message server-shell templates block-macros expressions everything

  or their numeric equivalent.

Pass-through AutoGen argument

trace-out option.

This is the “tracing output file or filter” option. This option takes a string argument ‘file’. Pass-through AutoGen argument

show-defs option.

This is the “show the definition tree” option. Pass-through AutoGen argument

used-defines option.

This is the “show the definitions used” option. Pass-through AutoGen argument

core option (-C).

This is the “leave a core dump on a failure exit” option.

This option has some usage constraints. It:

• must be compiled in by defining HAVE_SYS_RESOURCE_H during the compilation.

Many systems default to a zero sized core limit. If the system has the sys/resource.h header and if this option is supplied, then in the failure exit path, autogen will attempt to set the soft core limit to whatever the hard core limit is. If that does not work, then an administrator must raise the hard core size limit.

skip-suffix option (-s).

This is the “skip the file with this ‘suffix’” option. This option takes a string argument ‘SUFFIX’.

This option has some usage constraints. It:

• may appear an unlimited number of times.
• must not appear in combination with any of the following options: select-suffix.

Pass-through AutoGen argument

select-suffix option (-o).

This is the “specify this output suffix” option. This option takes a string argument ‘SUFFIX’.

This option has some usage constraints. It:

• may appear an unlimited number of times.

Pass-through AutoGen argument

define option (-D).

This is the “name to add to definition list” option. This option takes a string argument ‘value’.

This option has some usage constraints. It:

• may appear an unlimited number of times.

Pass-through AutoGen argument

undefine option (-U).

This is the “definition list removal pattern” option. This option takes a string argument ‘name-pat’.

This option has some usage constraints. It:

• may appear an unlimited number of times.

Pass-through AutoGen argument

make-dep option (-M).

This is the “emit make dependency file” option. This option takes an optional string argument ‘type’.

This option has some usage constraints. It:

• may appear an unlimited number of times.

Pass-through AutoGen argument

This document was generated by Bruce Korb on August 21, 2015 using texi2html 1.82.