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

FreeBSD Manual Pages

  
 
  

home | help
PKG_JAIL(1)			  User Manuals			     PKG_JAIL(1)

NAME
     pkg_jail - Easy handling of a jail for package-builds.

SYNOPSIS
     pkg_jail [command]

DESCRIPTION
     pkg_jail is a script to handle an clean jail for package-builds.

ARGUMENTS
     init   Creates  or  updates  a  clean jail with "installworld" and populate
	    /etc inside the jail.  You need to have a sucessful "buildword" made
	    in /usr/src before this.

     start  Start the jail as a guest server.  You should have setup sshd inside
	    the jail to login and maintain it with this option.

     shell  Start the jail and give a shell back. You can build packages now.

     list   Show processes running in the jail.  You need to have /proc  mounted
	    (readonly) in the host.

     stop   Kill  processes running in the jail.  You need to have /proc mounted
	    (readonly) in the host.

     restart
	    Same as "stop" and "start"

IMPLEMENTATION NOTES
     /proc  /proc will be mounted readonly via procfs inside the jail.

     /usr/src
	    if /usr/src/Makefile does not exists inside the jail, /usr/src  will
	    be mounted readonly via nullfs from the the host into the jail.

     pkg_jail_hostname
	    The hostname of the jail.

     pkg_jail_short
	    A short name for the jail.

     pkg_jail_ip
	    The ip-address for the jail.

     pkg_jail_dir
	    The new root for the jail.

     pkg_jail_rule
	    The rulset number the script uses for the devfs inside the jail.

RETURN VALUES
     undefined.

FILES
     The variables can be set in /etc/rc.conf or in $PREFIX/etc/pkg_jail.conf.

EXAMPLES
     Setting up the Jail Directory Tree

     Install all Files with the following comands on the host:

	    cd /usr/src && make buildworld
	    pkg_jail init

     Creating a Package

     Change to your management directory and execute pkg_upgrade:

	    cd /usr/ports/local/update
	    sh pkg_update make-packages devel/gmake

SEE ALSO
     pkg_update(1)
	    The tool to create packages inside the jail.

HISTORY
     http://www.dinoex.net/training/package.html

AUTHOR
     Dirk Meyer, dinoex@FreeBSD.org

FreeBSD 			   April 2010			     PKG_JAIL(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pkg_jail&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help