File: cvsd-buildroot.8.in

package info (click to toggle)
cvsd 1.0.24
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, bullseye, buster, jessie, jessie-kfreebsd, sid, stretch, trixie, wheezy
  • size: 1,180 kB
  • sloc: sh: 5,075; ansic: 1,860; perl: 198; makefile: 88
file content (76 lines) | stat: -rw-r--r-- 3,627 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
.\" Copyright (C) 2001, 2002, 2003, 2004, 2009 Arthur de Jong
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2, or (at your option)
.\" any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
.TH "cvsd\-buildroot" "8" "@RELEASE_MONTH@" "Version @VERSION@" "System Manager's Manual"
.nh
.SH "NAME"
cvsd\-buildroot \- create a chrooted directory structure for use in cvsd.
.SH "SYNOPSIS"
.B cvsd\-buildroot
.RI DIRECTORY
.SH "DESCRIPTION"
\fBcvsd\-buildroot\fP creates and populates a directory that can be used as a chroot jail for running cvsd (see
.BR 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.

\fBcvsd\-buildroot\fP creates the following directory structure:
.TP
.B \fB/bin\fP
This directory is populated with the cvs binary that is found on the system.
.TP
.B \fB/lib\fP
This directory is populated with all the libraries that are required for running programs in the \fB/bin\fP directory as well as some predefined required libraries that are present on the system.
.TP
.B \fB/dev\fP
Here null and zero devices are created.
.TP
.B \fB/etc\fP
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 \(oqx\(cq.
.TP
.B \fB/usr\fP
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.
.TP
.B \fB/libexec\fP and \fB/usr/libexec\fP
Symbolic links for these directories are created if they are present on the system.
.TP
.B \fB/tmp\fP
This directory is cleaned out on systems that have tmpreaper.
.PP
After the directories are created and populated ownership and rights are set to a reasonable value (root:root,umask=022).
.SH "OPTIONS"
\fBcvsd\-buildroot\fP takes one argument, namely a directory in which the chroot jail will be created. The directory should be specified with an absolute path.
.SH "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 <@PACKAGE_BUGREPORT@>.

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

.SH "SEE ALSO"
.BR cvsd (8)
.br
README
.br
FAQ
.SH "AUTHOR"
Arthur de Jong <arthur@arthurdejong.org>.