genassym(1) [netbsd man page]

GENASSYM(1)						    BSD 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 con-
     stants derived from the configuration information genassym reads from stdin. The generated file is used by kernel sources written in assem-
     bler 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.

BSD
								  April 13, 2010							       BSD

MARIA-CSO(1)						      General Commands Manual						      MARIA-CSO(1)

NAME

       maria-cso - shared library generator for maria

SYNOPSIS

       maria-cso directory library.so file.c...
       maria-cso directory library.so file.c

DESCRIPTION

       This manual page documents briefly the maria-cso command.

       maria-cso  is  a  shell	script	invoked  by maria in order to compile generated C code into dynamically loadable shared object files.  The
       script invokes the C compiler and the linker, and it calculates checksums in order to avoid compiling unmodified modules.
       The directory argument specifies the location of the source files.  When the script is invoked with one file.c argument, it translates  the
       file to the shared object library.so.
       When maria-cso is invoked with multiple file.c arguments, it computes a checksum of a file named multiset.h and of each argument.  When the
       header file multiset.h has been changed since the previous invocation of maria-cso, everything will be recompiled.   Otherwise  only  those
       file.c modules that have been modified will be recompiled.  The checksum files are multiset.sum and c.sum.

SEE ALSO

       maria(1), sh(1).

ENVIRONMENT VARIABLES

       CC     Name of the C compiler

       CFLAGS Command-line switches to be passed to the C compiler

       DEFINES
	      Preprocessor macro definitions to be passed to the C compiler

FILES

       /usr/share/maria/runtime/*.h
	      Header files for the run-time library

AUTHOR

       This  manual  page  was	written  by Marko Makela <msmakela@tcs.hut.fi>.  The maria-cso script and the compilation option were designed and
       implemented by Marko Makela.  Please see the copyright file in /usr/share/doc/maria for details.

								  August 10, 2001						      MARIA-CSO(1)