Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

cvsd-buildroot(8) [debian man page]

cvsd-buildroot(8)					      System Manager's Manual						 cvsd-buildroot(8)

NAME

       cvsd-buildroot - create a chrooted directory structure for use in cvsd.

SYNOPSIS

       cvsd-buildroot DIRECTORY

DESCRIPTION

       cvsd-buildroot creates and populates a directory that can be used as a chroot jail for running cvsd (see cvsd(8) ) in.

       This script should be run as the root user since the creation of devices and the changing of ownership and permissions require this.

       The script gives warnings about files that it's not expecting.

       cvsd-buildroot creates the following directory structure:

       /bin   This directory is populated with the cvs binary that is found on the system.

       /lib   This  directory  is  populated  with  all the libraries that are required for running programs in the /bin directory as well as some
	      predefined required libraries that are present on the system.

       /dev   Here null and zero devices are created.

       /etc   In this directory a passwd file is created that is used for matching user id's with usernames. The root and cvsd user are  added	to
	      this  file  if  they're  not there yet.  The passwd file is checked for consistency with the system /etc/passwd to prevent mistakes.
	      The passwd file is also populated with users referenced in the repository directories.  Note that no password data from  /etc/passwd
	      or any other file is stored in the generated passwd file, all password entries are set to 'x'.

       /usr   Here  symbolic  links  are placed to /bin and /lib for some common library and binary directories found on the system.  This is done
	      for systems that have hard-coded paths for libraries.

       /libexec and /usr/libexec
	      Symbolic links for these directories are created if they are present on the system.

       /tmp   This directory is cleaned out on systems that have tmpreaper.

       After the directories are created and populated ownership and rights are set to a reasonable value (root:root,umask=022).

OPTIONS

       cvsd-buildroot takes one argument, namely a directory in which the chroot jail will be created. The directory should be specified  with	an
       absolute path.

NOTES

       Creating  a  chroot environment is a terribly non-portable thing to do and therefore you may experience problems with missing libraries and
       system files.  For more information see the FAQ and the README.	If you have to	install  libraries  or	perform  actions  not  covered	by
       cvsd-buildroot please report your findings to <cvsd-users@lists.arthurdejong.org>.

       Rerunning  cvsd-buildroot  after  you have created your repository is advised since the repositories are checked for references to userid's
       and lockfile directories.

SEE ALSO

       cvsd(8)
       README
       FAQ

AUTHOR

       Arthur de Jong <arthur@arthurdejong.org>.

Version 1.0.24							     Jun 2012							 cvsd-buildroot(8)

Check Out this Related Man Page

chroot(1M)						  System Administration Commands						chroot(1M)

NAME

       chroot - change root directory for a command

SYNOPSIS

       /usr/sbin/chroot newroot command

DESCRIPTION

       The  chroot  utility causes command to be executed relative to newroot. The meaning of any initial slashes (/) in the path names is changed
       to newroot for command and any of its child processes. Upon execution, the initial working directory is newroot.

       Notice that redirecting the output of command to a file,

	 chroot newroot command >x

       will create the file x relative to the original root of command, not the new one.

       The new root path name is always relative to the current root. Even if a chroot is currently in effect, the newroot argument is relative to
       the current root of the running process.

       This command can be run only by the super-user.

RETURN VALUES

       The exit status of chroot is the return value of command.

EXAMPLES

       Example 1 Using the chroot Utility

       The  chroot  utility  provides an easy way to extract tar files (see tar(1)) written with absolute filenames to a different location. It is
       necessary to copy the shared libraries used by tar (see ldd(1)) to the newroot filesystem.

	 example# mkdir /tmp/lib; cd /lib
	 example# cp ld.so.1 libc.so.1 libcmd.so.1 libdl.so.1 
		  libsec.so.1 /tmp/lib
	 example# cp /usr/bin/tar /tmp
	 example# dd if=/dev/rmt/0 | chroot /tmp tar xvf -

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       cd(1), tar(1), chroot(2), ttyname(3C), attributes(5)

NOTES

       Exercise extreme caution when referencing device files in the new root file system.

       References by routines such as ttyname(3C) to stdin, stdout, and stderr will find that the device associated with the  file  descriptor	is
       unknown after chroot is run.

SunOS 5.11							    15 Dec 2003 							chroot(1M)
Man Page