Initial import from FreeBSD RELENG_4:
[dragonfly.git] / usr.bin / gensetdefs / gensetdefs.8
1 .\"
2 .\" $FreeBSD: src/usr.bin/gensetdefs/gensetdefs.8,v 1.2.2.2 2001/03/06 12:52:41 ru Exp $
3 .\"
4 .Dd March 10, 1999
5 .Dt GENSETDEFS 8
6 .Os
7 .Sh NAME
8 .Nm gensetdefs
9 .Nd generate linker set definitions
10 .Sh SYNOPSIS
11 .Nm
12 .Ar
13 .Sh DESCRIPTION
14 The
15 .Nm
16 command is a special-purpose program to generate the
17 linker set definitions needed when building an ELF kernel.
18 Its
19 .Ar file
20 arguments are the names of ELF object files.
21 It scans the section names of the object files,
22 building a table of those that begin with
23 .Dv .set. ,
24 which represent linker sets.  Finally, for each set
25 .Dv foo
26 with 
27 .Dv count
28 elements, it writes a line 
29 .Fn DEFINE_SET foo count ;
30 to the standard output.
31 .Pp
32 This command is used by the kernel
33 .Pa makefile ,
34 such as
35 .Pa /sys/i386/conf/Makefile.i386
36 generic makefile for the
37 .Tn i386 .
38 .Sh SEE ALSO
39 .Xr config 8
40 .Sh AUTHORS
41 The
42 .Nm
43 command was written by
44 .An John D. Polstra .