2 .\" $FreeBSD: src/usr.bin/genassym/genassym.8,v 1.2.2.1 2000/12/08 15:13:37 ru Exp $
3 .\" $DragonFly: src/usr.bin/genassym/Attic/genassym.8,v 1.2 2003/06/17 04:29:27 dillon Exp $
10 .Nd generate assembler symbols from C
18 command is a special-purpose program to generate assembler
19 symbols from C code and is used to interface the low-level
20 assembly code with the C code.
21 This, for example, is used
27 argument is the name of an ELF object file that holds the
29 These definitions are extracted from
30 the object file and written to standard output or to the
33 suitable for inclusion in assembler source files.
37 command only extracts symbols from the object file if they
40 and are global data types, whose value is the value given
42 The following C declaration
43 .Bd -literal -offset indent -compact
44 int assym_MY_SYMBOL = 3;
46 is used to create the following assembler symbol.
47 .Bd -literal -offset indent -compact
50 Note that the size of the symbol is extracted from the
51 object file, which means that the symbol may have any type
52 that is wide enough to hold the value.
59 command was written by
60 .An Marcel Moolenaar Aq marcel@FreeBSD.org
65 Not all linkers store the size of the symbol in the ELF
67 The GNU linker for Alpha has this bug for
68 example (binutils 2.9.1). In those cases the size of the
69 symbol is assumed to be equal to the word size of the ELF
71 For Alpha this is 64 bits and for i386 this
76 command first appeared in