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	 $PRE-
       FIX/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.0>

home | help