NAME

aconfig - configure a system


SYNOPSIS

aconfig arguments file


DESCRIPTION

There is normally no need to use aconfig directly.

aconfig is called by mkproduct to configure a system build.


ARGUMENTS

The following command line arguments are provided:

-a
automatically create all module subdirectories

-d symbol
automatically defines the specified symbol in the config.h and config.s files instead of the default __ATMOS__.

-e directory
copy every file that is used to another directory. For example, the command:

aconfig -a -n -e ~/export/atmos/source system

copies all the files used to make the system to ~/export/atmos/source. Here system refers to the system file that defines the image whose sources you wish to export. The ~/export/atmos/source directory must already exist.

This option does not work for modules that contain sub-directories (eg. tcp_ip).

-h
print summary help

-i
generate make rules to install a new version of the built modules

-l file
list every file used to the given file

-m name
specify the name of the makefile to generate

-n
do not use installed versions of modules

-q
execute quietly

-r directory
set its argument as the path to the root of the ATMOS source tree

-S symbolname[=value]
set symbolname to true. Can be used more than once. Optionally a value can be given to the symbol.

Example:

    aconfig -S someflag -S somevalue=3 mysystemfile

-v
specify which version of the released modules is to be used

-N
Suppress generation of the dependency rules on image. Use of this option will break mkproduct.

-c
Generate makefiles suitable for 'classic' make (i.e. do not use the -C option supported by GNU make).

-L
Arrange that the location of definitions placed in config.h and config.s is written (as a comment) to just before the definition. Example:
  /* from /atmos/source/software/version.pkg line 30 */
  #define ATML_COPYRIGHT     "Copyright (c) 2000 Virata Ltd"
  /* from /atmos/source/software/version.pkg line 35 */
  #define ATML_RELEASE       ""


DESCRIPTION

aconfig configures a system based on information provided in the configuration (system) file. A description of the system file syntax can be found in the ATMOS Book.


EXAMPLES

aconfig SYSTEM


ENVIRONMENT

ATMOSROOT
Specifies where to look for the ATMOS source directory (e.g. ~/atmos/source). The command-line opion overrides this value.

ATMOSVERSION
Specifies the ATMOS version. The command-line opion overrides this value.


SEE ALSO

The ATMOS Book, DO-007001-TC

The syntax of aconfig system files is described in the aconfig-syntax manpage.