Manual Page Result
0
Command: genassym | Section: 1 | Source: NetBSD | File: genassym.1
GENASSYM(1) FreeBSD General Commands Manual GENASSYM(1)
NAME
genassym - emit an assym.h file
SYNOPSIS
genassym [-c] [-f] C compiler invocation
DESCRIPTION
genassym is a shell script normally used during the kernel build process
to create an assym.h file. This file defines a number of cpp constants
derived from the configuration information genassym reads from stdin. The
generated file is used by kernel sources written in assembler to gain
access to information (e.g. structure offsets and sizes) normally only
known to the C compiler.
Arguments to genassym are usually of the form ${CC} ${CFLAGS} ${CPPFLAGS}
where ${CC} is the C compiler used to compile the kernel, while ${CFLAGS}
and ${CPPFLAGS} are flag arguments to the C compiler. The script creates
a C source file from its input. Then the C compiler is called according
to the script's arguments to compile this file.
Normally genassym instructs the C compiler to create an assembler source
from the constructed C source. The resulting file is then processed to
extract the information needed to create the assym.h file. The -c flag
instructs genassym to create slightly different code, generate an
executable from this code and run it. In both cases the assym.h file is
written to stdout. The -f flag instructs genassym to create forth code.
DIAGNOSTICS
Either self-explanatory, or generated by one of the programs called from
the script.
SEE ALSO
genassym.cf(5)
HISTORY
The genassym command appeared in NetBSD 1.3 as "genassym.sh" in
/usr/src/sys/kern. It became a userland utility in NetBSD 4.0.
FreeBSD 14.1-RELEASE-p8 April 13, 2010 FreeBSD 14.1-RELEASE-p8