~ubuntu-branches/ubuntu/trusty/apt/trusty

\fBapt\fR [\fB\-h\fR] [\fB\-o=\fR\fB\fIconfig_string\fR\fR] [\fB\-c=\fR\fB\fIconfig_file\fR\fR] [\fB\-t=\fR\fB\fItarget_release\fR\fR] [\fB\-a=\fR\fB\fIarchitecture\fR\fR] {list | search | show | update | install\ \fIpkg\fR\ [{=\fIpkg_version_number\fR\ |\ /\fItarget_release\fR}]... | remove\ \fIpkg\fR... | upgrade | full\-upgrade | edit\-sources | {\-v\ |\ \-\-version} | {\-h\ |\ \-\-help}}

.SH "DESCRIPTION"

.PP

\fBapt\fR

(Advanced Package Tool) is the command\-line tool for handling packages\&. It provides a commandline interface for the package management of the system\&. See also

\fBapt-get\fR(8)

and

\fBapt-cache\fR(8)

for more low\-level command options\&.

.PP

\fBlist\fR

.RS 4

list

is used to display a list of packages\&. It supports shell pattern for matching package names and the following options:

\fB\-\-installed\fR,

\fB\-\-upgradable\fR,

\fB\-\-all\-versions\fR

are supported\&.

.RE

.PP

\fBsearch\fR

.RS 4

searches for the given term(s) and display matching packages\&.

.RE

.PP

\fBshow\fR

.RS 4

show

shows the package information for the given package(s)\&.

.RE

.PP

\fBinstall\fR

.RS 4

install

is followed by one or more package names desired for installation or upgrading\&.

.sp

A specific version of a package can be selected for installation by following the package name with an equals and the version of the package to select\&. This will cause that version to be located and selected for install\&. Alternatively a specific distribution can be selected by following the package name with a slash and the version of the distribution or the Archive name (stable, testing, unstable)\&.

.RE

.PP

\fBremove\fR

.RS 4

remove

is identical to

install

except that packages are removed instead of installed\&. Note that removing a package leaves its configuration files on the system\&. If a plus sign is appended to the package name (with no intervening space), the identified package will be installed instead of removed\&.

.RE

.PP

\fBedit\-sources\fR

.RS 4

edit\-sources

lets you edit your sources\&.list file and provides basic sanity checks\&.

.RE

.PP

\fBupdate\fR

.RS 4

update

is used to resynchronize the package index files from their sources\&.

.RE

.PP

\fBupgrade\fR

.RS 4

upgrade

is used to install the newest versions of all packages currently installed on the system from the sources enumerated in

/etc/apt/sources\&.list\&. New package will be installed, but existing package will never removed\&.

.RE

100

.PP

101

\fBfull\-upgrade\fR

102

.RS 4

103

full\-upgrade

104

performs the function of upgrade but may also remove installed packages if that is required in order to resolve a package conflict\&.

105

.RE

106

.SH "OPTIONS"

107

.PP

108

All command line options may be set using the configuration file, the descriptions indicate the configuration option to set\&. For boolean options you can override the config file by using something like

109

\fB\-f\-\fR,\fB\-\-no\-f\fR,

110

\fB\-f=no\fR

111

or several other variations\&.

112

.PP

113

\fB\-h\fR, \fB\-\-help\fR

114

.RS 4

115

Show a short usage summary\&.

116

.RE

117

.PP

118

\fB\-v\fR, \fB\-\-version\fR

119

.RS 4

120

Show the program version\&.

121

.RE

122

.PP

123

\fB\-c\fR, \fB\-\-config\-file\fR

124

.RS 4

125

Configuration File; Specify a configuration file to use\&. The program will read the default configuration file and then this configuration file\&. If configuration settings need to be set before the default configuration files are parsed specify a file with the

126

\fBAPT_CONFIG\fR

127

environment variable\&. See

128

\fBapt.conf\fR(5)

129

for syntax information\&.

130

.RE

131

.PP

132

\fB\-o\fR, \fB\-\-option\fR

133

.RS 4

134

Set a Configuration Option; This will set an arbitrary configuration option\&. The syntax is

135

\fB\-o Foo::Bar=bar\fR\&.

136

\fB\-o\fR

137

and

138

\fB\-\-option\fR

139

can be used multiple times to set different options\&.

140

.RE

141

.SH "SCRIPT USAGE"

142

.PP

143

The

144

\fBapt\fR(8)

145

commandline is designed as a end\-user tool and it may change the output between versions\&. While it tries to not break backward compatibility there is no guarantee for it either\&. All features of

146

\fBapt\fR(8)

147

are available in

148

\fBapt-cache\fR(8)

149

and

150

\fBapt-get\fR(8)

151

via APT options\&. Please prefer using these commands in your scripts\&.

152

.SH "DIFFERENCES TO APT-GET(8)"

153

.PP

154

The

155

\fBapt\fR

156

command is meant to be pleasant for end users and does not need to be backward compatible like

157

\fBapt-get\fR(8)\&. Therefore some options are different:

158

.sp

159

.RS 4

160

.ie n \{\

161

\h'-04'\(bu\h'+03'\c

162

.\}

163

.el \{\

164

.sp -1

165

.IP \(bu 2.3

166

.\}

167

The option

168

DPkgPM::Progress\-Fancy

169

is enabled\&.

170

.RE

171

.sp

172

.RS 4

173

.ie n \{\

174

\h'-04'\(bu\h'+03'\c

175

.\}

176

.el \{\

177

.sp -1

178

.IP \(bu 2.3

179

.\}

180

The option

181

APT::Color

182

is enabled\&.

183

.RE

184

.sp

185

.RS 4

186

.ie n \{\

187

\h'-04'\(bu\h'+03'\c

188

.\}

189

.el \{\

190

.sp -1

191

.IP \(bu 2.3

192

.\}

193

A new

194

list

195

command is available similar to

196

dpkg \-\-list\&.

197

.RE

198

.sp

199

.RS 4

200

.ie n \{\

201

\h'-04'\(bu\h'+03'\c

202

.\}

203

.el \{\

204

.sp -1

205

.IP \(bu 2.3

206

.\}

207

The option

208

upgrade

209

has

210

\-\-with\-new\-pkgs

211

enabled by default\&.

212

.RE

213

.sp

214

.SH "SEE ALSO"

215

.PP

216

\fBapt-get\fR(8),

217

\fBapt-cache\fR(8),

218

\fBsources.list\fR(5),

219

\fBapt.conf\fR(5),

220

\fBapt-config\fR(8), The APT User\*(Aqs guide in /usr/share/doc/apt\-doc/,

221

\fBapt_preferences\fR(5), the APT Howto\&.

222

.SH "DIAGNOSTICS"

223

.PP

224

\fBapt\fR

225

returns zero on normal operation, decimal 100 on error\&.

226

.SH "BUGS"

227

.PP

228

\m[blue]\fBAPT bug page\fR\m[]\&\s-2\u[1]\d\s+2\&. If you wish to report a bug in APT, please see

229

/usr/share/doc/debian/bug\-reporting\&.txt

230

or the

231

\fBreportbug\fR(1)

232

command\&.

233

.SH "AUTHOR"

234

.PP

235

\fBAPT team\fR

236

.RS 4

237

.RE

238

.SH "NOTES"

239

.IP " 1." 4

240

APT bug page

241

.RS 4

242

\%http://bugs.debian.org/src:apt

243

.RE

Older »