← Back to branch summary

~fai/fai/fai.hardy

« back to all changes in this revision

Viewing changes to man/install_packages.8

  • Committer: Reinhard Tartler
  • Date: 2008-02-14 09:38:36 UTC
  • mfrom: (1.1.4052 ubuntu)
  • Revision ID: siretart@tauware.de-20080214093836-7h0setrddcbdu62q
Upload of 3.2.1-0ubuntu1 to gutsy

this merge contains all commits up to to release of 3.2.1-0ubuntu1 to
gutsy.

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/install_packages.8
 
1
.\"                                      Hey, EMACS: -*- nroff -*-
 
2
.if \n(zZ=1 .ig zZ
 
3
.if \n(zY=1 .ig zY
 
4
.TH install_packages 8 "12 august 2007" "FAI 3.2"
 
5
.\" Please adjust this date whenever revising the manpage.
 
6
.\"
 
7
.\" Some roff macros, for reference:
 
8
.\" .nh        disable hyphenation
 
9
.\" .hy        enable hyphenation
 
10
.\" .ad l      left justify
 
11
.\" .ad b      justify to both left and right margins
 
12
.\" .nf        disable filling
 
13
.\" .fi        enable filling
 
14
.\" .br        insert line break
 
15
.\" .sp <n>    insert n+1 empty lines
 
16
.\" for manpage-specific macros, see man(7)
 
17
.de }1
 
18
.ds ]X \&\\*(]B\\
 
19
.nr )E 0
 
20
.if !"\\$1"" .nr )I \\$1n
 
21
.}f
 
22
.ll \\n(LLu
 
23
.in \\n()Ru+\\n(INu+\\n()Iu
 
24
.ti \\n(INu
 
25
.ie !\\n()Iu+\\n()Ru-\w\\*(]Xu-3p \{\\*(]X
 
26
.br\}
 
27
.el \\*(]X\h|\\n()Iu+\\n()Ru\c
 
28
.}f
 
29
..
 
30
.\"
 
31
.\" File Name macro.  This used to be `.PN', for Path Name,
 
32
.\" but Sun doesn't seem to like that very much.
 
33
.\"
 
34
.de FN
 
35
\fI\|\\$1\|\fP
 
36
..
 
37
.SH NAME
 
38
install_packages \- install FAI configured packages
 
39
.SH SYNOPSIS
 
40
.B install_packages
 
41
.SH DESCRIPTION
 
42
Fully Automatic Installation (FAI) is used to provide unattended installation of
 
43
Debian GNU/Linux operating systems with a very flexible class-based system.
 
44
install_packages is a Perl script written for FAI to selectively install, hold,
 
45
remove, or purge packages or tasks.
 
46
 
 
47
install_packages is called from the fai installation script and should not be
 
48
called directly.  Its function is to parse the package_config files based on
 
49
the class definitions of the client.  For example, if the client belonged to
 
50
the SMTPSERVER class, install_packages would parse ../package_config/SMTPSERVER
 
51
for instructions on what packages to install, hold, remove, or purge.
 
52
 
 
53
.SH OPTIONS
 
54
.TP
 
55
.B \-d
 
56
Only download packages instead of installing them. Variable
 
57
$aptoptions must be set.
 
58
.TP
 
59
.B \-h
 
60
Show help, version and summary of options.
 
61
.TP
 
62
.B \-H
 
63
Show list of all available commands for the file in package_config.
 
64
.TP
 
65
.B \-l
 
66
Print only the list of all packages that would be installed, then exit.
 
67
.TP
 
68
.B \-L
 
69
Print the list of all packages with version number that would be installed, then exit.
 
70
.TP
 
71
.B \-m MAX
 
72
Install only MAX packages at a time. Same as setting the shell
 
73
environment variable MAXPACKAGES.
 
74
.TP
 
75
.BI "\-n "
 
76
Dry run. Do not execute installation commands, just print them.
 
77
.TP
 
78
.B \-N
 
79
Do not check package names if they are valid.
 
80
.TP
 
81
.BI "\-p " DIRECTORY
 
82
Read the configuration files from DIRECTORY instead of $FAI/packages_config.
 
83
.TP
 
84
.B \-v
 
85
Be verbose.
 
86
 
 
87
 
 
88
.SH NOTES
 
89
.PD 0
 
90
install_packages expects to find the FAI_ROOT directory, the location of class
 
91
definitions, package configurations, and custom install scripts, somewhere in
 
92
the filesystem.  This location is configurable in /etc/fai/fai.conf and defaults to
 
93
/srv/fai/config.
 
94
.PD
 
95
.SH SEE ALSO
 
96
.PD 0
 
97
This program is part of FAI (Fully Automatic Installation).  See the FAI manual
 
98
for more information on how to use install_packages.  The FAI homepage is
 
99
http://www.informatik.uni-koeln.de/fai.
 
100
.TP
 
101
\fIapt\fP(1), \fIaptitude\fP(8), \fIapt-get\fP(8), \fIdpkg\fP(8), \fItasksel\fP(1)
 
102
.PD
 
103
.SH FILES
 
104
.PD 0
 
105
.TP
 
106
.FN /etc/fai/fai.conf
 
107
The FAI configuration file.
 
108
 
 
109
.TP
 
110
.FN /srv/fai/config/package_config/
 
111
The FAI package configuration directory.
 
112
 
 
113
.SH AUTHOR
 
114
Thomas Lange <lange@informatik.uni-koeln.de>