aconfig - configure a system
aconfig arguments file
There is normally no need to use aconfig directly.
aconfig is called by mkproduct to configure a system build.
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 ""
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.
aconfig SYSTEM
- 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.
The ATMOS Book, DO-007001-TC
The syntax of aconfig system files is described in the aconfig-syntax manpage.