aboutsummaryrefslogtreecommitdiffstats
path: root/doc/slapt-get.8
blob: d0428cbd7844a0e990fcf2f90695a6c09873c20c (plain)
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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
.\" -*- nroff -*-
.ds g \" empty
.ds G \" empty
.\" Like TP, but if specified indent is more than half
.\" the current line-length - indent, use the default indent.
.de Tp
.ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
.el .TP "\\$1"
..
.TH slapt-get 8 
.SH NAME
slapt-get \- frontend to pkgtools
.SH SYNOPSIS
.B slapt-get
[
.B option(s)
]
[
.BI target
]
.LP
.B options:
[
.B --download-only
]
[
.B --simulate|-s
]
[
.B --no-prompt|-y
]
[
.B --prompt|-p
]
[
.B --reinstall
]
[
.B --ignore-excludes
]
[
.B --no-md5
]
[
.B --ignore-dep
]
[
.B --no-dep
]
[
.B --print-uris
]
[
.B --show-stats|-S
]
[
.B --config []
]
[
.B --remove-obsolete
]
[
.B --retry []
]
[
.B --no-upgrade
]
.LP
.B targets:
[
.B --update
]
[
.B --upgrade
]
[
.B --dist-upgrade
]
[
.B --install
]
[
.B --install-set
]
[
.B --remove
]
[
.B --show
]
[
.B --search
]
[
.B --list
]
[
.B --available
]
[
.B --installed
]
[
.B --clean
]
[
.B --autoclean
]
[
.B --version
]
.SH DESCRIPTION
.B slapt-get
is an APT like system for Slackware package management.  It
allows one to search for packages, install them, and upgrade the
installed packages all with a few simple commands.  Additional
features include listing all available packages, listing all
installed packages, and removing installed packages.
.B slapt-get
tries to emulate Debian's apt-get as closely as possible.
.SH OPTIONS
.TP
.B --download-only
Download the package only.  Do not install/upgrade.  Packages are downloaded to /var/slapt-get/.
.TP
.B --simulate|-s
Will not install or download packages.
.TP
.B --no-prompt|-y
Do not prompt for package upgrade/remove confirmation.
.TP
.B --prompt|-p
Always prompt for package install confirmation.
.TP
.B --reinstall
Install the package even if it is already installed.
.TP
.B --ignore-excludes
Ignore exclude list and install excluded packages anyway.
.TP
.B --no-md5
Do not perform MD5 check sum on package.  This is dangerous!
.TP
.B --ignore-dep
Ignore dependency failures on --install, --upgrade, or --dist-upgrade
.TP
.B --no-dep
Skip the dependency check
.TP
.B --print-uris
Print URIs of packages to be downloaded to stdout, but do not download.
.TP
.B --show-stats|-S
Show the download statistics
.TP
.B --config []
Specify file location of slapt-get configuration.  This overrides the default location, /etc/slapt-get/slapt-getrc.
.TP
.B --remove-obsolete
Remove installed packages that are no longer available.  This works for dist-upgrade only.  This removes packages that are no longer available from any current package sources, but are currently installed.  Be careful as this will also remove custom built packages.  
.TP
.B --retry []
Specify the number of retries to attempt if the package download fails.
.TP
.B --no-upgrade
Install the package rather than attempting to detect if a previous version is installed and upgrading it.  This is useful for installing kernel packages.  This option is only valid for --install targets.
.SH TARGETS
.TP
.B --update
Retrieves package data from MIRROR location.
.TP
.B --upgrade
Upgrade installed packages if newer versions are available.
.TP
.B --dist-upgrade
Upgrade to newer Slackware release.  This is the same as --upgrade, with the addition of checking to make sure that all the base packages, from the base disk set, are also installed.  Prior to running dist-upgrade, make sure that the package cache is updated and the crucial packages (glibc-solibs, sed, and pkgtools) are upgraded.  See UPGRADE.TXT on your local Slackware mirror.
.TP
.B --install [package(s)]
Install specified package(s).  Packages can be package names or package names with version (example: pkg-1.0-i386-1).
.TP
.B --install-set [disk set(s)]
Install specified disk set(s).  example: --install-set xap n l
.TP
.B --remove [package(s)]
Remove specified package(s).  Packages can be package names or package names with version (example: pkg-1.0-i386-1).
.TP
.B --show [package]
Show package description.  Package can be a package name or package name with version (example: pkg-1.0-i386-1).
.TP
.B --search [expression]
Search available packages. Applies POSIX and extended regular expression
to the names, locations, and descriptions of packages.
.TP
.B --list
List all packages, installed and available.
.TP
.B --available
List available packages only.  This will show you the packages present on your current sources.
.TP
.B --installed
List installed packages only.
.TP
.B --clean
Purge cached/downloaded packages from WORKINGDIR (/var/slapt-get/ by default).
.TP
.B --autoclean
Like  clean, autoclean clears out the local repository of retrieved package files. The difference is that it only removes package files that can no longer be downloaded, and are largely useless. This allows a cache to be maintained over  a  long  period without  it  growing  out  of control.
.TP
.B --version
Print version and license info.
.SH NOTES
.TP
slapt-get uses pkgtools for installing, upgrading, and removing.
.TP
slapt-get will not make assumptions or do things without you telling it to.
.TP
slapt-get can only attempt to resolve dependencies and conflicts for those packages that were built with this information.  Vanilla Slackware packages (ie official Slackware packages) do not contain this data, thus slapt-get performs with --no-dep on by default.
.TP
Untested updates are risky, whether using official packages or third party packages.
.TP
slapt-get will not change your system such that you can only use slapt-get or are somehow locked into using slapt-get.  The only additions to your system are /etc/slapt-get and /var/slapt-get.  You are free to try another solution or go back to manual upgradepkg.
.TP
UPGRADE.TXT and ChangeLog.txt is still required reading, the latter is especially true when running -current.

.SH FILES
/etc/slapt-get/slapt-getrc

.SH AUTHOR
Jason Woodward <woodwardj@jaos.org>
.SH "SEE ALSO"
.BR installpkg(8),
.BR makepkg(8),
.BR removepkg(8),
.BR explodepkg(8),
.BR pkgtool(8), 
.BR upgradepkg(8),
.BR netrc(5)