Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
BUILD(7)	     BSD Miscellaneous Information Manual	      BUILD(7)

     build -- information on how to build the system

     The source	for the	FreeBSD	system and applications	are contained in three
     different directories, normally /usr/src, /usr/doc, and /usr/ports.
     /usr/src contains the "base system" sources, which	is loosely defined as
     the things	required to rebuild the	system to a useful state.  /usr/doc
     contains the source for the system	documentation, excluding the manual
     pages.  /usr/ports	is a tree that provides	a consistent interface for
     building and installing third party applications.

     The make(1) command is used in each of these directories to build and in-
     stall the things in that directory.  Issuing the make(1) command in any
     directory or subdirectory of those	directories has	the same effect	as is-
     suing the same command in all subdirectories of that directory.  With no
     target specified, the things in that directory are	just built.  The fol-
     lowing list provides the names and	actions	for other targets:

     clean	 Removes any files created during the build process.

     install	 Installs the results of the build for this directory.

     update	 Gets updated sources as configured in make.conf(5).

     The other /usr/src	make targets are:

     buildworld	 Rebuild everything but	the kernel, configure files in /etc,
		 and release.

		 Install everything built by buildworld.

		 Rebuild the kernel and	the kernel modules.

		 Install the kernel and	the kernel modules.

		 Reinstall the kernel and the kernel modules.

     kernel	 Equivalent to buildkernel followed by installkernel

     Convenience targets for cleaning up the install destination directory de-
     noted by variable DESTDIR include:

     check-old	      Print a list of old files	and directores in the system.

     delete-old	      Delete obsolete base system files	and directories	inter-
		      actively.	 When -DBATCH_DELETE_OLD_FILES is specified at
		      the command line,	the delete operation will be non-in-
		      teractive.  The variables	DESTDIR, TARGET_ARCH and
		      TARGET should be set as with "make installworld".

     delete-old-libs  Delete obsolete base system libraries interactively.
		      This target should only be used if no 3rd	party software
		      uses these libraries.  When -DBATCH_DELETE_OLD_FILES is
		      specified	at the command line, the delete	operation will
		      be non-interactive.  The variables DESTDIR, TARGET_ARCH
		      and TARGET should	be set as with "make installworld".

     For more information about	the ports build	process, see ports(7).

     TARGET_ARCH  The target machine processor architecture.  This is analo-
		  gous to the "uname -p" output.  Set this to cross-build for
		  a different architecture.

     TARGET	  The target hardware platform.	 This is analogous to the
		  "uname -m" output.  This is necessary	to cross-build some
		  target architectures.	 For example, cross-building for PC98
		  machines requires TARGET_ARCH=i386 and TARGET=pc98.

     NO_WERROR	  If defined, warnings will not	cause the build	to halt, even
		  if the makefile says otherwise.

     DESTDIR	  The directory	hierarchy where	the resulting binaries will be


     For an "approved" method of updating your system from the latest sources,
     please see	the COMMON ITEMS section in src/UPDATING.

     The following sequence of commands	can be used to cross-build the system
     for the Alpha architecture	on an i386 host:

	   cd /usr/src
	   make	TARGET_ARCH=alpha buildworld
	   make	TARGET_ARCH=alpha DESTDIR=/clients/axp installworld

     cc(1), install(1),	make(1), make.conf(5), ports(7), release(7),
     config(8),	mergemaster(8),	reboot(8), shutdown(8)

     Mike W. Meyer <>.

BSD			       January 07, 2006				   BSD


Want to link to this manual page? Use this URL:

home | help