| crunchgen.1 (93435) | crunchgen.1 (95127) |
|---|---|
| 1.\" 2.\" Copyright (c) 1994 University of Maryland 3.\" All Rights Reserved. 4.\" 5.\" Permission to use, copy, modify, distribute, and sell this software and its 6.\" documentation for any purpose is hereby granted without fee, provided that 7.\" the above copyright notice appear in all copies and that both that 8.\" copyright notice and this permission notice appear in supporting --- 8 unchanged lines hidden (view full) --- 17.\" BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 18.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 19.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR 20.\" IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 21.\" 22.\" Author: James da Silva, Systems Design and Analysis Group 23.\" Computer Science Department 24.\" University of Maryland at College Park | 1.\" 2.\" Copyright (c) 1994 University of Maryland 3.\" All Rights Reserved. 4.\" 5.\" Permission to use, copy, modify, distribute, and sell this software and its 6.\" documentation for any purpose is hereby granted without fee, provided that 7.\" the above copyright notice appear in all copies and that both that 8.\" copyright notice and this permission notice appear in supporting --- 8 unchanged lines hidden (view full) --- 17.\" BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 18.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 19.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR 20.\" IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 21.\" 22.\" Author: James da Silva, Systems Design and Analysis Group 23.\" Computer Science Department 24.\" University of Maryland at College Park |
| 25.\" $FreeBSD: head/usr.sbin/crunch/crunchgen/crunchgen.1 93435 2002-03-30 16:48:30Z luigi $ | 25.\" $FreeBSD: head/usr.sbin/crunch/crunchgen/crunchgen.1 95127 2002-04-20 12:27:18Z charnier $ |
| 26.\" 27.Dd November 16, 2000 28.Dt CRUNCHGEN 1 29.Os 30.Sh NAME 31.Nm crunchgen 32.Nd generates build environment for a crunched binary 33.Sh SYNOPSIS --- 13 unchanged lines hidden (view full) --- 47The crunched binary 48.Fn main 49function determines which component program to run by the contents of 50.Va argv[0] . 51The main reason to crunch programs together is for fitting 52as many programs as possible onto an installation or system recovery 53floppy. 54.Pp | 26.\" 27.Dd November 16, 2000 28.Dt CRUNCHGEN 1 29.Os 30.Sh NAME 31.Nm crunchgen 32.Nd generates build environment for a crunched binary 33.Sh SYNOPSIS --- 13 unchanged lines hidden (view full) --- 47The crunched binary 48.Fn main 49function determines which component program to run by the contents of 50.Va argv[0] . 51The main reason to crunch programs together is for fitting 52as many programs as possible onto an installation or system recovery 53floppy. 54.Pp |
| 55The |
|
| 55.Nm | 56.Nm |
| 56reads in the specifications in | 57utility reads in the specifications in |
| 57.Ar conf-file 58for a crunched binary, and generates a 59.Pa Makefile 60and accompanying 61top-level C source file that when built creates the crunched executable 62file from the component programs. 63For each component program, 64.Nm 65can optionally attempt to determine the object (.o) files that make up 66the program from its source directory 67.Pa Makefile . 68This information is cached between runs. | 58.Ar conf-file 59for a crunched binary, and generates a 60.Pa Makefile 61and accompanying 62top-level C source file that when built creates the crunched executable 63file from the component programs. 64For each component program, 65.Nm 66can optionally attempt to determine the object (.o) files that make up 67the program from its source directory 68.Pa Makefile . 69This information is cached between runs. |
| 70The |
|
| 69.Nm | 71.Nm |
| 70uses the companion program | 72utility uses the companion program |
| 71.Xr crunchide 1 72to eliminate link-time conflicts between the component programs by 73hiding all unnecessary symbols. 74.Pp | 73.Xr crunchide 1 74to eliminate link-time conflicts between the component programs by 75hiding all unnecessary symbols. 76.Pp |
| 77The |
|
| 75.Nm | 78.Nm |
| 76places specific requirements on package | 79utility places specific requirements on package |
| 77.Pa Makefile Ns s 78which make it unsuitable for use with 79.No non- Ns Bx 80sources. 81In particular, the 82.Pa Makefile 83must contain the target 84.Ic depend , --- 75 unchanged lines hidden (view full) --- 160.Ev MAKEOBJDIRPREFIX 161environment variable, or 162.Pa /usr/obj . 163.It Fl q 164Quiet operation. 165Status messages are suppressed. 166.El 167.Sh CRUNCHGEN CONFIGURATION FILE COMMANDS | 80.Pa Makefile Ns s 81which make it unsuitable for use with 82.No non- Ns Bx 83sources. 84In particular, the 85.Pa Makefile 86must contain the target 87.Ic depend , --- 75 unchanged lines hidden (view full) --- 163.Ev MAKEOBJDIRPREFIX 164environment variable, or 165.Pa /usr/obj . 166.It Fl q 167Quiet operation. 168Status messages are suppressed. 169.El 170.Sh CRUNCHGEN CONFIGURATION FILE COMMANDS |
| 171The |
|
| 168.Nm | 172.Nm |
| 169reads specifications from the | 173utility reads specifications from the |
| 170.Ar conf-file 171that describe the components of the crunched binary. 172In its simplest 173use, the component program names are merely listed along with the 174top-level source directories in which their sources can be found. | 174.Ar conf-file 175that describe the components of the crunched binary. 176In its simplest 177use, the component program names are merely listed along with the 178top-level source directories in which their sources can be found. |
| 179The |
|
| 175.Nm | 180.Nm |
| 176then calculates (via the source makefiles) and caches the | 181utility then calculates (via the source makefiles) and caches the |
| 177list of object files and their locations. 178For more specialized 179situations, the user can specify by hand all the parameters that 180.Nm 181needs. 182.Pp 183The 184.Ar conf-file --- 244 unchanged lines hidden (view full) --- 429.Bx 430build environment do not by default build the 431intermediate object file for single-source file programs. 432The 433.Dq Li make objs 434must then be used to get those object files built, or 435some other arrangements made. 436.Sh AUTHORS | 182list of object files and their locations. 183For more specialized 184situations, the user can specify by hand all the parameters that 185.Nm 186needs. 187.Pp 188The 189.Ar conf-file --- 244 unchanged lines hidden (view full) --- 434.Bx 435build environment do not by default build the 436intermediate object file for single-source file programs. 437The 438.Dq Li make objs 439must then be used to get those object files built, or 440some other arrangements made. 441.Sh AUTHORS |
| 442The |
|
| 437.Nm | 443.Nm |
| 438was written by | 444utility was written by |
| 439.An James da Silva Aq jds@cs.umd.edu . 440.Pp 441Copyright (c) 1994 University of Maryland. 442All Rights Reserved. | 445.An James da Silva Aq jds@cs.umd.edu . 446.Pp 447Copyright (c) 1994 University of Maryland. 448All Rights Reserved. |