mirror of
https://github.com/moparisthebest/pacman
synced 2025-01-08 12:28:00 -05:00
Remove generated man pages from CVS
This commit is contained in:
parent
e8275fa964
commit
3e5401b74d
@ -1,25 +0,0 @@
|
||||
.TH libalpm 3 "29 Jan 2006" "Frugalware Developer Manual" ""
|
||||
.SH NAME
|
||||
libalpm \- Arch Linux package management library
|
||||
.SH SYNOPSIS
|
||||
For ease of access, the libalpm manual has been split up into several sections.
|
||||
|
||||
.nf
|
||||
alpm_databases Database Functions
|
||||
alpm_dep Dependency Functions
|
||||
alpm_groups Group Functions
|
||||
alpm_interface Interface Functions
|
||||
alpm_list List Functions
|
||||
alpm_log Logging Functions
|
||||
alpm_misc Miscellaneous Functions
|
||||
alpm_options Library Options
|
||||
alpm_packages Package Functions
|
||||
alpm_sync Sync Functions
|
||||
alpm_trans Transaction Functions
|
||||
.fi
|
||||
|
||||
.SH AUTHOR
|
||||
.nf
|
||||
Judd Vinet <jvinet@zeroflux.org>
|
||||
and the Frugalware developers <frugalware-devel@frugalware.org>
|
||||
.fi
|
156
doc/makepkg.8
156
doc/makepkg.8
@ -1,156 +0,0 @@
|
||||
.TH makepkg 8 "January 30, 2006" "Frugalware Developer Manual" ""
|
||||
.SH NAME
|
||||
makepkg \- package build utility
|
||||
.SH SYNOPSIS
|
||||
\fBmakepkg [options]\fP
|
||||
.SH DESCRIPTION
|
||||
\fBmakepkg\fP will build packages for you. All it needs is
|
||||
a build-capable linux platform, wget, and some build scripts. The advantage
|
||||
to a script-based build is that you only really do the work once. Once you
|
||||
have the build script for a package, you just need to run makepkg and it
|
||||
will do the rest: download and validate source files, check dependencies,
|
||||
configure the buildtime settings, build the package, install the package
|
||||
into a temporary root, make customizations, generate meta-info, and package
|
||||
the whole thing up for \fBpacman\fP to use.
|
||||
|
||||
\fBmakeworld\fP can be used to rebuild an entire package group or the
|
||||
entire build tree. See \fBmakeworld --help\fP for syntax.
|
||||
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
.B "\-b, \-\-builddeps"
|
||||
Build missing dependencies from source. When makepkg finds missing build-time or
|
||||
run-time dependencies, it will look for the dependencies' FrugalBuild files under
|
||||
$fst_root (set in your /etc/repoman.conf). If it finds them it will
|
||||
run another copy of makepkg to build and install the missing dependencies.
|
||||
The child makepkg calls will be made with the \fB-b\fP and \fB-i\fP options.
|
||||
.TP
|
||||
.B "\-B, \-\-noccache"
|
||||
Do not use ccache during build.
|
||||
.TP
|
||||
.B "\-c, \-\-clean"
|
||||
Clean up leftover work files/directories after a successful build.
|
||||
.TP
|
||||
.B "\-C, \-\-cleancache"
|
||||
Used with --chroot cleans up the chroot which means removing unnecessary
|
||||
packages from it. If used twice, then it removes all source files from
|
||||
the cache directory and cleans up the full compiler cache to free up diskspace.
|
||||
.TP
|
||||
.B "\-d, \-\-nodeps"
|
||||
Do not perform any dependency checks. This will let you override/ignore any
|
||||
dependencies required. There's a good chance this option will break the build
|
||||
process if all of the dependencies aren't installed.
|
||||
.TP
|
||||
.B "\-D <pkgname>"
|
||||
Clean up only one package's compiler cache. (Uses ccache -C.)
|
||||
.TP
|
||||
.B "\-e, \-\-noextract"
|
||||
Do not extract source files. Instead, use whatever already exists in the
|
||||
src/ directory. This is handy if you want to go into src and manually
|
||||
patch/tweak code, then make a package out of the result.
|
||||
.TP
|
||||
.B "\-f, \-\-force"
|
||||
\fBmakepkg\fP will not build a package if a \fIpkgname-pkgver-pkgrel-arch.fpm\fP
|
||||
file already exists in the build directory. You can override this behaviour with
|
||||
the \fB--force\fP switch.
|
||||
.TP
|
||||
.B "\-G, \-\-genmd5"
|
||||
Download all source files (if required) and use \fImd5sum\fP to generate md5 hashes
|
||||
for each of them. You can then redirect the output into your FrugalBuild for source
|
||||
validation (makepkg -G >>FrugalBuild).
|
||||
.TP
|
||||
.B "\-g, \-\-gensha1"
|
||||
Download all source files (if required) and use \fIsha1sum\fP to generate sha1 hashes
|
||||
for each of them. You can then redirect the output into your FrugalBuild for source
|
||||
validation (makepkg -g >>FrugalBuild).
|
||||
.TP
|
||||
.B "\-h, \-\-help"
|
||||
Output syntax and commandline options.
|
||||
.TP
|
||||
.B "\-i, \-\-install"
|
||||
Install/Upgrade the package after a successful build.
|
||||
.TP
|
||||
.B "\-j <jobs>"
|
||||
Sets MAKEFLAGS="-j<jobs>" before building the package. This is useful for overriding
|
||||
the MAKEFLAGS setting in /etc/makepkg.conf.
|
||||
.TP
|
||||
.B "\-L, \-\-nolastmod"
|
||||
Disable updating the Last modified line.
|
||||
.TP
|
||||
.B "\-k, \-\-logging"
|
||||
Logging package build process
|
||||
.TP
|
||||
.B "\-l <pkgname>"
|
||||
Download the package's buildscript before starting the build. This is useful
|
||||
if you do not want to do a full 'repoman upd' nor want to download manually the
|
||||
buildscript.
|
||||
.TP
|
||||
.B "\-m, \-\-nocolor"
|
||||
Disable color in output messages
|
||||
.TP
|
||||
.B "\-n, \-\-nostrip"
|
||||
Do not strip binaries and libraries.
|
||||
.TP
|
||||
.B "\-o, \-\-nobuild"
|
||||
Download and extract files only, do not build.
|
||||
.TP
|
||||
.B "\-p <buildscript>"
|
||||
Read the package script \fI<buildscript>\fP instead of the default (\fIFrugalBuild\fP).
|
||||
.TP
|
||||
.B "\-r, \-\-rmdeps"
|
||||
Upon successful build, remove any dependencies installed by makepkg/pacman during
|
||||
dependency auto-resolution (using \fB-b\fP or \fB-s\fP).
|
||||
.TP
|
||||
.B "\-R, \-\-chroot"
|
||||
Build the package in a chroot environment.
|
||||
.TP
|
||||
.B "\-s, \-\-syncdeps"
|
||||
Install missing dependencies using pacman. When makepkg finds missing build-time
|
||||
or run-time dependencies, it will run pacman to try and resolve them. If successful,
|
||||
pacman will download the missing packages from a package repository and
|
||||
install them for you.
|
||||
.TP
|
||||
.B "\-t <tree>"
|
||||
When building in a chroot (using -R) you may want to build packages for a
|
||||
version other than the host one. Using this option, it's possible to build
|
||||
packages for "stable" while the host system is "current" and vica versa.
|
||||
.TP
|
||||
.B "\-u, \-\-noup2date"
|
||||
Do not check for newer version before starting build. Normally makepkg will
|
||||
prevent you from building obsolete source by mistake. If you know what you are
|
||||
doing, you can disable this feature with this switch.
|
||||
.B "\-S, \-\-sudosync"
|
||||
Install missing dependencies using pacman and sudo. This is the same as \fB-s\fP
|
||||
except that makepkg will call pacman with sudo. This means you don't have to
|
||||
build as root to use dependency auto-resolution.
|
||||
.TP
|
||||
.TP
|
||||
.B "\-w <destdir>"
|
||||
Write the resulting package file to the directory \fI<destdir>\fP instead of the
|
||||
current working directory.
|
||||
.TP
|
||||
.B "\-\-noconfirm"
|
||||
When calling pacman to resolve dependencies or conflicts, makepkg can pass
|
||||
the \fI--noconfirm\fP option to it so it does not wait for any user
|
||||
input before proceeding with operations.
|
||||
.TP
|
||||
.B "\-\-noprogressbar"
|
||||
When calling pacman, makepkg can pass the \fI--noprogressbar\fP option to it.
|
||||
This is useful if one is directing makepkg's output to a non-terminal (ie, a file).
|
||||
|
||||
.SH CONFIGURATION
|
||||
Configuration options are stored in \fI/etc/makepkg.conf\fP. This file is parsed
|
||||
as a bash script, so you can export any special compiler flags you wish
|
||||
to use. This is helpful for building for different architectures, or with
|
||||
different optimizations.
|
||||
|
||||
\fBNOTE:\fP This does not guarantee that all package Makefiles will use
|
||||
your exported variables. Some of them are flaky...
|
||||
.SH "SEE ALSO"
|
||||
.BR FrugalBuild (8),
|
||||
.BR pacman (8)
|
||||
.SH AUTHOR
|
||||
.nf
|
||||
Judd Vinet <jvinet@zeroflux.org>
|
||||
and the Frugalware developers <frugalware-devel@frugalware.org>
|
||||
.fi
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_dep.3
|
@ -1,211 +0,0 @@
|
||||
.TH "Database Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*-
|
||||
.ad l
|
||||
.nh
|
||||
.SH NAME
|
||||
Database Functions \- Frunctions to query and manipulate the database of libalpm.
|
||||
|
||||
.PP
|
||||
.SS "Functions"
|
||||
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.RI "pmdb_t * \fBalpm_db_register\fP (char *treename, alpm_cb_db_register callback)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "int \fBalpm_db_unregister\fP (pmdb_t *db)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "void * \fBalpm_db_getinfo\fP (PM_DB *db, unsigned char parm)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "int \fBalpm_db_setserver\fP (pmdb_t *db, char *url)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "int \fBalpm_db_update\fP (int level, PM_DB *db)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "pmpkg_t * \fBalpm_db_readpkg\fP (pmdb_t *db, char *name)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "PMList * \fBalpm_db_getpkgcache\fP (pmdb_t *db)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "PMList * \fBalpm_db_whatprovides\fP (pmdb_t *db, char *name)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "pmgrp_t * \fBalpm_db_readgrp\fP (pmdb_t *db, char *name)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "PMList * \fBalpm_db_getgrpcache\fP (pmdb_t *db)"
|
||||
.br
|
||||
.in -1c
|
||||
.SH "Detailed Description"
|
||||
.PP
|
||||
Frunctions to query and manipulate the database of libalpm.
|
||||
.PP
|
||||
.SH "Function Documentation"
|
||||
.PP
|
||||
.SS "PMList* alpm_db_getgrpcache (pmdb_t * db)"
|
||||
.PP
|
||||
Get the group cache of a package database
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIdb\fP pointer to the package database to get the group from
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
the list of groups on success, NULL on error
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "void* alpm_db_getinfo (PM_DB * db, unsigned char parm)"
|
||||
.PP
|
||||
Get informations about a database.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIdb\fP database pointer
|
||||
.br
|
||||
\fIparm\fP name of the info to get
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
a void* on success (the value), NULL on error
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "PMList* alpm_db_getpkgcache (pmdb_t * db)"
|
||||
.PP
|
||||
Get the package cache of a package database
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIdb\fP pointer to the package database to get the package from
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
the list of packages on success, NULL on error
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "pmgrp_t* alpm_db_readgrp (pmdb_t * db, char * name)"
|
||||
.PP
|
||||
Get a group entry from a package database
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIdb\fP pointer to the package database to get the group from
|
||||
.br
|
||||
\fIname\fP of the group
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
the groups entry on success, NULL on error
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "pmpkg_t* alpm_db_readpkg (pmdb_t * db, char * name)"
|
||||
.PP
|
||||
Get a package entry from a package database
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIdb\fP pointer to the package database to get the package from
|
||||
.br
|
||||
\fIname\fP of the package
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
the package entry on success, NULL on error
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "pmdb_t* alpm_db_register (char * treename, alpm_cb_db_register callback)"
|
||||
.PP
|
||||
Register a package database
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fItreename\fP the name of the repository
|
||||
.br
|
||||
\fIcallback\fP a function to be called upon new database creation
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
0 on success, -1 on error (pm_errno is set accordingly)
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "int alpm_db_setserver (pmdb_t * db, char * url)"
|
||||
.PP
|
||||
Set the serverlist of a database.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIdb\fP database pointer
|
||||
.br
|
||||
\fIurl\fP url of the server
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
0 on success, -1 on error (pm_errno is set accordingly)
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "int alpm_db_unregister (pmdb_t * db)"
|
||||
.PP
|
||||
Unregister a package database
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIdb\fP pointer to the package database to unregister
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
0 on success, -1 on error (pm_errno is set accordingly)
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "int alpm_db_update (int level, PM_DB * db)"
|
||||
.PP
|
||||
Update a package database
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIlevel\fP control for checking lastupdate time
|
||||
.br
|
||||
\fIdb\fP pointer to the package database to update
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
0 on success, > 0 on error (pm_errno is set accordingly), < 0 if up to date
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "PMList* alpm_db_whatprovides (pmdb_t * db, char * name)"
|
||||
.PP
|
||||
Get the list of packages that a package provides
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIdb\fP pointer to the package database to get the package from
|
||||
.br
|
||||
\fIname\fP name of the package
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
the list of packages on success, NULL on error
|
||||
.RE
|
||||
.PP
|
||||
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_databases.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_databases.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_databases.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_databases.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_databases.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_databases.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_sync.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_databases.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_databases.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_databases.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_databases.3
|
@ -1,57 +0,0 @@
|
||||
.TH "Dependency Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*-
|
||||
.ad l
|
||||
.nh
|
||||
.SH NAME
|
||||
Dependency Functions \- Functions to get informations about a libalpm dependency.
|
||||
|
||||
.PP
|
||||
.SS "Functions"
|
||||
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.RI "void * \fBalpm_dep_getinfo\fP (pmdepmissing_t *miss, unsigned char parm)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "void * \fBalpm_conflict_getinfo\fP (pmconflict_t *conflict, unsigned char parm)"
|
||||
.br
|
||||
.in -1c
|
||||
.SH "Detailed Description"
|
||||
.PP
|
||||
Functions to get informations about a libalpm dependency.
|
||||
.PP
|
||||
.SH "Function Documentation"
|
||||
.PP
|
||||
.SS "void* alpm_conflict_getinfo (pmconflict_t * conflict, unsigned char parm)"
|
||||
.PP
|
||||
Get informations about a file conflict.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIconflict\fP database conflict structure
|
||||
.br
|
||||
\fIparm\fP name of the info to get
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
a char* on success (the value), NULL on error
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "void* alpm_dep_getinfo (pmdepmissing_t * miss, unsigned char parm)"
|
||||
.PP
|
||||
Get informations about a dependency.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fImiss\fP dependency pointer
|
||||
.br
|
||||
\fIparm\fP name of the info to get
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
a char* on success (the value), NULL on error
|
||||
.RE
|
||||
.PP
|
||||
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_dep.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_misc.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_misc.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_options.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_misc.3
|
@ -1,37 +0,0 @@
|
||||
.TH "Group Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*-
|
||||
.ad l
|
||||
.nh
|
||||
.SH NAME
|
||||
Group Functions \- Functions to get informations about libalpm groups.
|
||||
|
||||
.PP
|
||||
.SS "Functions"
|
||||
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.RI "void * \fBalpm_grp_getinfo\fP (pmgrp_t *grp, unsigned char parm)"
|
||||
.br
|
||||
.in -1c
|
||||
.SH "Detailed Description"
|
||||
.PP
|
||||
Functions to get informations about libalpm groups.
|
||||
.PP
|
||||
.SH "Function Documentation"
|
||||
.PP
|
||||
.SS "void* alpm_grp_getinfo (pmgrp_t * grp, unsigned char parm)"
|
||||
.PP
|
||||
Get informations about a group.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIgrp\fP group pointer
|
||||
.br
|
||||
\fIparm\fP name of the info to get
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
a char* on success (the value), NULL on error
|
||||
.RE
|
||||
.PP
|
||||
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_groups.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_interface.3
|
@ -1,48 +0,0 @@
|
||||
.TH "Interface Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*-
|
||||
.ad l
|
||||
.nh
|
||||
.SH NAME
|
||||
Interface Functions \- Function to initialize and release libalpm.
|
||||
|
||||
.PP
|
||||
.SS "Functions"
|
||||
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.RI "int \fBalpm_initialize\fP (char *root)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "int \fBalpm_release\fP ()"
|
||||
.br
|
||||
.in -1c
|
||||
.SH "Detailed Description"
|
||||
.PP
|
||||
Function to initialize and release libalpm.
|
||||
.PP
|
||||
.SH "Function Documentation"
|
||||
.PP
|
||||
.SS "int alpm_initialize (char * root)"
|
||||
.PP
|
||||
Initializes the library. This must be called before any other functions are called.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIroot\fP the full path of the root we'll be installing to (usually /)
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
0 on success, -1 on error (pm_errno is set accordingly)
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "int alpm_release ()"
|
||||
.PP
|
||||
Release the library. This should be the last alpm call you make.
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
0 on success, -1 on error (pm_errno is set accordingly)
|
||||
.RE
|
||||
.PP
|
||||
|
@ -1,107 +0,0 @@
|
||||
.TH "List Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*-
|
||||
.ad l
|
||||
.nh
|
||||
.SH NAME
|
||||
List Functions \- Functions to manipulate libalpm linked lists.
|
||||
|
||||
.PP
|
||||
.SS "Functions"
|
||||
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.RI "PMList * \fBalpm_list_first\fP (PMList *list)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "PMList * \fBalpm_list_next\fP (PMList *entry)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "void * \fBalpm_list_getdata\fP (PMList *entry)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "int \fBalpm_list_free\fP (PMList *entry)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "int \fBalpm_list_count\fP (PMList *list)"
|
||||
.br
|
||||
.in -1c
|
||||
.SH "Detailed Description"
|
||||
.PP
|
||||
Functions to manipulate libalpm linked lists.
|
||||
.PP
|
||||
.SH "Function Documentation"
|
||||
.PP
|
||||
.SS "int alpm_list_count (PMList * list)"
|
||||
.PP
|
||||
Count the entries in a list.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIlist\fP the list to count
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
number of entries on success, NULL on error
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "PMList* alpm_list_first (PMList * list)"
|
||||
.PP
|
||||
Get the first element of a list.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIlist\fP the list
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
the first element
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "int alpm_list_free (PMList * entry)"
|
||||
.PP
|
||||
Free a list.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIentry\fP list to free
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
0 on success, -1 on error
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "void* alpm_list_getdata (PMList * entry)"
|
||||
.PP
|
||||
Get the data of a list entry.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIentry\fP the list entry
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
the data on success, NULL on error
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "PMList* alpm_list_next (PMList * entry)"
|
||||
.PP
|
||||
Get the next element of a list.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIentry\fP the list entry
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
the next element on success, NULL on error
|
||||
.RE
|
||||
.PP
|
||||
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_list.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_list.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_list.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_list.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_list.3
|
@ -1,35 +0,0 @@
|
||||
.TH "Logging Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*-
|
||||
.ad l
|
||||
.nh
|
||||
.SH NAME
|
||||
Logging Functions \- Functions to log using libalpm.
|
||||
|
||||
.PP
|
||||
.SS "Functions"
|
||||
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.RI "int \fBalpm_logaction\fP (char *fmt,...)"
|
||||
.br
|
||||
.in -1c
|
||||
.SH "Detailed Description"
|
||||
.PP
|
||||
Functions to log using libalpm.
|
||||
.PP
|
||||
.SH "Function Documentation"
|
||||
.PP
|
||||
.SS "int alpm_logaction (char * fmt, ...)"
|
||||
.PP
|
||||
A printf-like function for logging.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIfmt\fP output format
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
0 on success, -1 on error (pm_errno is set accordingly)
|
||||
.RE
|
||||
.PP
|
||||
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_log.3
|
@ -1,93 +0,0 @@
|
||||
.TH "Miscellaneous Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*-
|
||||
.ad l
|
||||
.nh
|
||||
.SH NAME
|
||||
Miscellaneous Functions \- Various libalpm functions.
|
||||
|
||||
.PP
|
||||
.SS "Functions"
|
||||
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.RI "char * \fBalpm_get_md5sum\fP (char *name)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "char * \fBalpm_get_sha1sum\fP (char *name)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "char * \fBalpm_fetch_pkgurl\fP (char *url)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "int \fBalpm_parse_config\fP (char *file, alpm_cb_db_register callback, const char *this_section)"
|
||||
.br
|
||||
.in -1c
|
||||
.SH "Detailed Description"
|
||||
.PP
|
||||
Various libalpm functions.
|
||||
.PP
|
||||
.SH "Function Documentation"
|
||||
.PP
|
||||
.SS "char* alpm_fetch_pkgurl (char * url)"
|
||||
.PP
|
||||
Fetch a remote pkg.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIurl\fP
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
the downloaded filename on success, NULL on error
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "char* alpm_get_md5sum (char * name)"
|
||||
.PP
|
||||
Get the md5 sum of file.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIname\fP name of the file
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
the checksum on success, NULL on error
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "char* alpm_get_sha1sum (char * name)"
|
||||
.PP
|
||||
Get the sha1 sum of file.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIname\fP name of the file
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
the checksum on success, NULL on error
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "int alpm_parse_config (char * file, alpm_cb_db_register callback, const char * this_section)"
|
||||
.PP
|
||||
Parses a configuration file.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIfile\fP path to the config file.
|
||||
.br
|
||||
\fIcallback\fP a function to be called upon new database creation
|
||||
.br
|
||||
\fIthis_section\fP the config current section being parsed
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
0 on success, -1 on error (pm_errno is set accordingly)
|
||||
.RE
|
||||
.PP
|
||||
|
@ -1,57 +0,0 @@
|
||||
.TH "Library Options" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*-
|
||||
.ad l
|
||||
.nh
|
||||
.SH NAME
|
||||
Library Options \- Functions to set and get libalpm options.
|
||||
|
||||
.PP
|
||||
.SS "Functions"
|
||||
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.RI "int \fBalpm_set_option\fP (unsigned char parm, unsigned long data)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "int \fBalpm_get_option\fP (unsigned char parm, long *data)"
|
||||
.br
|
||||
.in -1c
|
||||
.SH "Detailed Description"
|
||||
.PP
|
||||
Functions to set and get libalpm options.
|
||||
.PP
|
||||
.SH "Function Documentation"
|
||||
.PP
|
||||
.SS "int alpm_get_option (unsigned char parm, long * data)"
|
||||
.PP
|
||||
Get the value of a library option.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIparm\fP the parameter to get
|
||||
.br
|
||||
\fIdata\fP pointer argument to get the value in
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
0 on success, -1 on error (pm_errno is set accordingly)
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "int alpm_set_option (unsigned char parm, unsigned long data)"
|
||||
.PP
|
||||
Set a library option.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIparm\fP the name of the parameter
|
||||
.br
|
||||
\fIdata\fP the value of the parameter
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
0 on success, -1 on error (pm_errno is set accordingly)
|
||||
.RE
|
||||
.PP
|
||||
|
@ -1,131 +0,0 @@
|
||||
.TH "Package Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*-
|
||||
.ad l
|
||||
.nh
|
||||
.SH NAME
|
||||
Package Functions \- Functions to manipulate libalpm packages.
|
||||
|
||||
.PP
|
||||
.SS "Functions"
|
||||
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.RI "void * \fBalpm_pkg_getinfo\fP (pmpkg_t *pkg, unsigned char parm)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "int \fBalpm_pkg_load\fP (char *filename, pmpkg_t **pkg)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "int \fBalpm_pkg_free\fP (pmpkg_t *pkg)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "int \fBalpm_pkg_checksha1sum\fP (pmpkg_t *pkg)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "int \fBalpm_pkg_checkmd5sum\fP (pmpkg_t *pkg)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "int \fBalpm_pkg_vercmp\fP (const char *ver1, const char *ver2)"
|
||||
.br
|
||||
.in -1c
|
||||
.SH "Detailed Description"
|
||||
.PP
|
||||
Functions to manipulate libalpm packages.
|
||||
.PP
|
||||
.SH "Function Documentation"
|
||||
.PP
|
||||
.SS "int alpm_pkg_checkmd5sum (pmpkg_t * pkg)"
|
||||
.PP
|
||||
Check the integrity (with md5) of a package from the sync cache.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIpkg\fP package pointer
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
0 on success, -1 on error (pm_errno is set accordingly)
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "int alpm_pkg_checksha1sum (pmpkg_t * pkg)"
|
||||
.PP
|
||||
Check the integrity (with sha1) of a package from the sync cache.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIpkg\fP package pointer
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
0 on success, -1 on error (pm_errno is set accordingly)
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "int alpm_pkg_free (pmpkg_t * pkg)"
|
||||
.PP
|
||||
Free a package.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIpkg\fP package pointer to free
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
0 on success, -1 on error (pm_errno is set accordingly)
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "void* alpm_pkg_getinfo (pmpkg_t * pkg, unsigned char parm)"
|
||||
.PP
|
||||
Get informations about a package.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIpkg\fP package pointer
|
||||
.br
|
||||
\fIparm\fP name of the info to get
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
a char* on success (the value), NULL on error
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "int alpm_pkg_load (char * filename, pmpkg_t ** pkg)"
|
||||
.PP
|
||||
Create a package from a file.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIfilename\fP location of the package tarball
|
||||
.br
|
||||
\fIpkg\fP address of the package pointer
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
0 on success, -1 on error (pm_errno is set accordingly)
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "int alpm_pkg_vercmp (const char * ver1, const char * ver2)"
|
||||
.PP
|
||||
Compare versions.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIver1\fP first version
|
||||
.br
|
||||
\fIver2\fP secont version
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
postive, 0 or negative if ver1 is less, equal or more than ver2, respectively.
|
||||
.RE
|
||||
.PP
|
||||
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_misc.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_packages.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_packages.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_packages.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_packages.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_packages.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_packages.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_interface.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_options.3
|
@ -1,55 +0,0 @@
|
||||
.TH "Sync Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*-
|
||||
.ad l
|
||||
.nh
|
||||
.SH NAME
|
||||
Sync Functions \- Functions to get informations about libalpm syncs.
|
||||
|
||||
.PP
|
||||
.SS "Functions"
|
||||
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.RI "void * \fBalpm_sync_getinfo\fP (pmsyncpkg_t *sync, unsigned char parm)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "PMList * \fBalpm_db_search\fP (pmdb_t *db)"
|
||||
.br
|
||||
.in -1c
|
||||
.SH "Detailed Description"
|
||||
.PP
|
||||
Functions to get informations about libalpm syncs.
|
||||
.PP
|
||||
.SH "Function Documentation"
|
||||
.PP
|
||||
.SS "PMList* alpm_db_search (pmdb_t * db)"
|
||||
.PP
|
||||
Searches a database
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIdb\fP pointer to the package database to search in
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
the list of packages on success, NULL on error
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "void* alpm_sync_getinfo (pmsyncpkg_t * sync, unsigned char parm)"
|
||||
.PP
|
||||
Get informations about a sync.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIsync\fP pointer
|
||||
.br
|
||||
\fIparm\fP name of the info to get
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
a char* on success (the value), NULL on error
|
||||
.RE
|
||||
.PP
|
||||
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_sync.3
|
@ -1,141 +0,0 @@
|
||||
.TH "Transaction Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*-
|
||||
.ad l
|
||||
.nh
|
||||
.SH NAME
|
||||
Transaction Functions \- Functions to manipulate libalpm transactions.
|
||||
|
||||
.PP
|
||||
.SS "Functions"
|
||||
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.RI "void * \fBalpm_trans_getinfo\fP (unsigned char parm)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "int \fBalpm_trans_init\fP (unsigned char type, unsigned int flags, alpm_trans_cb_event event, alpm_trans_cb_conv conv, alpm_trans_cb_progress progress)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "int \fBalpm_trans_sysupgrade\fP ()"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "int \fBalpm_trans_addtarget\fP (char *target)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "int \fBalpm_trans_prepare\fP (PMList **data)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "int \fBalpm_trans_commit\fP (PMList **data)"
|
||||
.br
|
||||
.ti -1c
|
||||
.RI "int \fBalpm_trans_release\fP ()"
|
||||
.br
|
||||
.in -1c
|
||||
.SH "Detailed Description"
|
||||
.PP
|
||||
Functions to manipulate libalpm transactions.
|
||||
.PP
|
||||
.SH "Function Documentation"
|
||||
.PP
|
||||
.SS "int alpm_trans_addtarget (char * target)"
|
||||
.PP
|
||||
Add a target to the transaction.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fItarget\fP the name of the target to add
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
0 on success, -1 on error (pm_errno is set accordingly)
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "int alpm_trans_commit (PMList ** data)"
|
||||
.PP
|
||||
Commit a transaction.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIdata\fP the address of a PM_LIST where detailed description of an error can be dumped (ie. list of conflicting files)
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
0 on success, -1 on error (pm_errno is set accordingly)
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "void* alpm_trans_getinfo (unsigned char parm)"
|
||||
.PP
|
||||
Get informations about the transaction.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIparm\fP name of the info to get
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
a char* on success (the value), NULL on error
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "int alpm_trans_init (unsigned char type, unsigned int flags, alpm_trans_cb_event event, alpm_trans_cb_conv conv, alpm_trans_cb_progress progress)"
|
||||
.PP
|
||||
Initialize the transaction.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fItype\fP type of the transaction
|
||||
.br
|
||||
\fIflags\fP flags of the transaction (like nodeps, etc)
|
||||
.br
|
||||
\fIevent\fP event callback function pointer
|
||||
.br
|
||||
\fIconv\fP question callback function pointer
|
||||
.br
|
||||
\fIprogress\fP progress callback function pointer
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
0 on success, -1 on error (pm_errno is set accordingly)
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "int alpm_trans_prepare (PMList ** data)"
|
||||
.PP
|
||||
Prepare a transaction.
|
||||
.PP
|
||||
\fBParameters:\fP
|
||||
.RS 4
|
||||
\fIdata\fP the address of a PM_LIST where detailed description of an error can be dumped (ie. list of conflicting files)
|
||||
.RE
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
0 on success, -1 on error (pm_errno is set accordingly)
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "int alpm_trans_release ()"
|
||||
.PP
|
||||
Release a transaction.
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
0 on success, -1 on error (pm_errno is set accordingly)
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.SS "int alpm_trans_sysupgrade ()"
|
||||
.PP
|
||||
Search for packages to upgrade and add them to the transaction.
|
||||
.PP
|
||||
\fBReturns:\fP
|
||||
.RS 4
|
||||
0 on success, -1 on error (pm_errno is set accordingly)
|
||||
.RE
|
||||
.PP
|
||||
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_trans.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_trans.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_trans.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_trans.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_trans.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_trans.3
|
@ -1 +0,0 @@
|
||||
.so man3/alpm_trans.3
|
359
doc/pacman.8
359
doc/pacman.8
@ -1,359 +0,0 @@
|
||||
.TH pacman 8 "January 21, 2006" "Frugalware User Manual" ""
|
||||
.SH NAME
|
||||
pacman \- package manager utility
|
||||
.SH SYNOPSIS
|
||||
\fBpacman <operation> [options] <package> [package] ...\fP
|
||||
.SH DESCRIPTION
|
||||
\fBpacman\fP is a \fIpackage management\fP utility that tracks installed
|
||||
packages on a linux system. It has simple dependency support and the ability
|
||||
to connect to a remote ftp server and automatically upgrade packages on
|
||||
the local system. pacman package are \fIbzipped tar\fP format.
|
||||
.SH OPERATIONS
|
||||
.TP
|
||||
.B "\-A, \-\-add"
|
||||
Add a package to the system. Package will be uncompressed
|
||||
into the installation root and the database will be updated.
|
||||
.TP
|
||||
.B "\-F, \-\-freshen"
|
||||
This is like --upgrade except that, unlike --upgrade, this will only
|
||||
upgrade packages that are already installed on your system.
|
||||
.TP
|
||||
.B "\-Q, \-\-query"
|
||||
Query the package database. This operation allows you to
|
||||
view installed packages and their files, as well as meta-info
|
||||
about individual packages (dependencies, conflicts, install date,
|
||||
build date, size). This can be run against the local package
|
||||
database or can be used on individual .fpm packages. See
|
||||
\fBQUERY OPTIONS\fP below.
|
||||
.TP
|
||||
.B "\-c, \-\-changelog"
|
||||
View the changelog of a package.
|
||||
.TP
|
||||
.B "\-R, \-\-remove"
|
||||
Remove a package from the system. Files belonging to the
|
||||
specified package will be deleted, and the database will
|
||||
be updated. Most configuration files will be saved with a
|
||||
\fI.pacsave\fP extension unless the \fB--nosave\fP option was
|
||||
used.
|
||||
.TP
|
||||
.B "\-S, \-\-sync"
|
||||
Synchronize packages. With this function you can install packages
|
||||
directly from the ftp servers, complete with all dependencies required
|
||||
to run the packages. For example, \fBpacman -S qt\fP will download
|
||||
qt and all the packages it depends on and install them. You could also use
|
||||
\fBpacman -Su\fP to upgrade all packages that are out of date (see below).
|
||||
.TP
|
||||
.B "\-U, \-\-upgrade"
|
||||
Upgrade a package. This is essentially a "remove-then-add"
|
||||
process. See \fBHANDLING CONFIG FILES\fP for an explanation
|
||||
on how pacman takes care of config files.
|
||||
.TP
|
||||
.B "\-V, \-\-version"
|
||||
Display version and exit.
|
||||
.TP
|
||||
.B "\-h, \-\-help"
|
||||
Display syntax for the given operation. If no operation was
|
||||
supplied then the general syntax is shown.
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
.B "\-d, \-\-nodeps"
|
||||
Skips all dependency checks. Normally, pacman will always check
|
||||
a package's dependency fields to ensure that all dependencies are
|
||||
installed and there are no package conflicts in the system. This
|
||||
switch disables these checks.
|
||||
.TP
|
||||
.B "\-f, \-\-force"
|
||||
Bypass file conflict checks, overwriting conflicting files. If the
|
||||
package that is about to be installed contains files that are already
|
||||
installed, this option will cause all those files to be overwritten.
|
||||
This option should be used with care, ideally not at all.
|
||||
.TP
|
||||
.B "\-r, \-\-root <path>"
|
||||
Specify alternative installation root (default is "/"). This
|
||||
should \fInot\fP be used as a way to install software into
|
||||
e.g. /usr/local instead of /usr. Instead this should be used
|
||||
if you want to install a package on a temporary mounted partition,
|
||||
which is "owned" by another system. By using this option you not only
|
||||
specify where the software should be installed, but you also
|
||||
specify which package database to use.
|
||||
.TP
|
||||
.B "\-v, \-\-verbose"
|
||||
Output more status and error messages.
|
||||
.TP
|
||||
.B "\-\-config <path>"
|
||||
Specify an alternate configuration file.
|
||||
.TP
|
||||
.B "\-\-noconfirm"
|
||||
Bypass any and all "Are you sure?" messages. It's not a good idea to do this
|
||||
unless you want to run pacman from a script.
|
||||
.TP
|
||||
.B "\-\-ask <number>"
|
||||
Finetune the --noconfirm switch by not answering "yes" to all libalpm
|
||||
questions, but you are able to specify yes/no for all type of libalpm
|
||||
questions. The types are the followings:
|
||||
.nf
|
||||
The given package is in IgnorePkg. (1)
|
||||
Replace package foo with bar? (2)
|
||||
foo conflicts with bar. Remove bar? (4)
|
||||
Do you want to delete the corrupted package? (8)
|
||||
Local version is newer. (16)
|
||||
Local version is up to date. (32)
|
||||
.fi
|
||||
Select for what types do you want to answer yes, sum up the values and use the
|
||||
result as a parameter to this option.
|
||||
.TP
|
||||
.B "\-\-noprogressbar"
|
||||
Do not show a progress bar when downloading files. This can be useful for
|
||||
scripts that call pacman and capture the output.
|
||||
.SH SYNC OPTIONS
|
||||
.TP
|
||||
.B "\-c, \-\-clean"
|
||||
Remove old packages from the cache. When pacman downloads packages,
|
||||
it saves them in \fI/var/cache/pacman/pkg\fP. If you need to free up
|
||||
diskspace, you can remove these packages by using the --clean option.
|
||||
Using one --clean (or -c) switch will only remove \fIold\fP packages.
|
||||
Use it twice to remove \fIall\fP packages from the cache.
|
||||
.TP
|
||||
.B "\-e, \-\-dependsonly"
|
||||
Don't install the packages itself, only their dependencies. This can be
|
||||
handy if you want to install the packages themselves with different
|
||||
options or from source.
|
||||
.TP
|
||||
.B "\-g, \-\-groups"
|
||||
Display all the members for each package group specified. If no group
|
||||
names are provided, all groups will be listed.
|
||||
.TP
|
||||
.B "\-i, \-\-info"
|
||||
Display dependency information for a given package. This will search
|
||||
through all repositories for a matching package and display the
|
||||
dependencies, conflicts, etc.
|
||||
.TP
|
||||
.B "\-l, \-\-list"
|
||||
List all files in the specified repositories. Multiple repositories can
|
||||
be specified on the command line.
|
||||
.TP
|
||||
.B "\-p, \-\-print-uris"
|
||||
Print out URIs for each package that will be installed, including any
|
||||
dependencies that have yet to be installed. These can be piped to a
|
||||
file and downloaded at a later time, using a program like wget.
|
||||
.TP
|
||||
.B "\-s, \-\-search <regexp>"
|
||||
This will search each package in the package list for names or descriptions
|
||||
that contains <regexp>.
|
||||
.TP
|
||||
.B "\-u, \-\-sysupgrade"
|
||||
Upgrades all packages that are out of date. pacman will examine every
|
||||
package installed on the system, and if a newer package exists on the
|
||||
server it will upgrade. pacman will present a report of all packages
|
||||
it wants to upgrade and will not proceed without user confirmation.
|
||||
Dependencies are automatically resolved at this level and will be
|
||||
installed/upgraded if necessary.
|
||||
.TP
|
||||
.B "\-w, \-\-downloadonly"
|
||||
Retrieve all packages from the server, but do not install/upgrade anything.
|
||||
.TP
|
||||
.B "\-y, \-\-refresh"
|
||||
Download a fresh copy of the master package list from the ftp server
|
||||
defined in \fI/etc/pacman.conf\fP. This should typically be used each
|
||||
time you use \fB--sysupgrade\fP.
|
||||
.TP
|
||||
.B "\-\-ignore <pkg>"
|
||||
This option functions exactly the same as the \fBIgnorePkg\fP configuration
|
||||
directive. Sometimes it can be handy to skip some package updates without
|
||||
having to edit \fIpacman.conf\fP each time.
|
||||
.SH REMOVE OPTIONS
|
||||
.TP
|
||||
.B "\-c, \-\-cascade"
|
||||
Remove all target packages, as well as all packages that depend on one
|
||||
or more target packages. This operation is recursive.
|
||||
.TP
|
||||
.B "\-k, \-\-keep"
|
||||
Removes the database entry only. Leaves all files in place.
|
||||
.TP
|
||||
.B "\-n, \-\-nosave"
|
||||
Instructs pacman to ignore file backup designations. Normally, when
|
||||
a file is about to be \fIremoved\fP from the system the database is first
|
||||
checked to see if the file should be renamed to a .pacsave extension. If
|
||||
\fB--nosave\fP is used, these designations are ignored and the files are
|
||||
removed.
|
||||
.TP
|
||||
.B "\-s, \-\-recursive"
|
||||
For each target specified, remove it and all its dependencies, provided
|
||||
that (A) they are not required by other packages; and (B) they were not
|
||||
explicitly installed by the user.
|
||||
This option is analagous to a backwards --sync operation.
|
||||
.SH QUERY OPTIONS
|
||||
.TP
|
||||
.B "\-e, \-\-orphans"
|
||||
List all packages that were installed as a dependency (ie, not
|
||||
installed explicitly) and are not required by any other
|
||||
packages.
|
||||
.TP
|
||||
.B "\-g, \-\-groups"
|
||||
Display all groups that a specified package is part of. If no package
|
||||
names are provided, all groups and members will be listed.
|
||||
.TP
|
||||
.B "\-i, \-\-info"
|
||||
Display information on a given package. If it is used with the \fB-p\fP
|
||||
option then the .PKGINFO file will be printed.
|
||||
.TP
|
||||
.B "\-l, \-\-list"
|
||||
List all files owned by <package>. Multiple packages can be specified on
|
||||
the command line.
|
||||
.TP
|
||||
.B "\-m, \-\-foreign"
|
||||
List all packages that were not found in the sync database(s). Typically these
|
||||
are packages that were downloaded manually and installed with --add.
|
||||
.TP
|
||||
.B "\-o, \-\-owns <file>"
|
||||
Search for the package that owns <file>.
|
||||
.TP
|
||||
.B "\-p, \-\-file"
|
||||
Tells pacman that the package supplied on the command line is a
|
||||
file, not an entry in the database. Pacman will decompress the
|
||||
file and query it. This is useful with \fB--info\fP and \fB--list\fP.
|
||||
.TP
|
||||
.B "\-s, \-\-search <regexp>"
|
||||
This will search each locally-installed package for names or descriptions
|
||||
that contains <regexp>.
|
||||
.SH HANDLING CONFIG FILES
|
||||
pacman uses the same logic as rpm to determine action against files
|
||||
that are designated to be backed up. During an upgrade, it uses 3
|
||||
md5 hashes for each backup file to determine the required action:
|
||||
one for the original file installed, one for the new file that's about
|
||||
to be installed, and one for the actual file existing on the filesystem.
|
||||
After comparing these 3 hashes, the follow scenarios can result:
|
||||
.TP
|
||||
original=\fBX\fP, current=\fBX\fP, new=\fBX\fP
|
||||
All three files are the same, so we win either way. Install the new file.
|
||||
.TP
|
||||
original=\fBX\fP, current=\fBX\fP, new=\fBY\fP
|
||||
The current file is un-altered from the original but the new one is
|
||||
different. Since the user did not ever modify the file, and the new
|
||||
one may contain improvements/bugfixes, we install the new file.
|
||||
.TP
|
||||
original=\fBX\fP, current=\fBY\fP, new=\fBX\fP
|
||||
Both package versions contain the exact same file, but the one
|
||||
on the filesystem has been modified since. In this case, we leave
|
||||
the current file in place.
|
||||
.TP
|
||||
original=\fBX\fP, current=\fBY\fP, new=\fBY\fP
|
||||
The new one is identical to the current one. Win win. Install the new file.
|
||||
.TP
|
||||
original=\fBX\fP, current=\fBY\fP, new=\fBZ\fP
|
||||
All three files are different, so we install the new file with a .pacnew
|
||||
extension and warn the user, so she can manually move the file into place
|
||||
after making any necessary customizations.
|
||||
.SH CONFIGURATION
|
||||
pacman will attempt to read \fI/etc/pacman.conf\fP each time it is invoked. This
|
||||
configuration file is divided into sections or \fIrepositories\fP. Each section
|
||||
defines a package repository that pacman can use when searching for packages in
|
||||
--sync mode. The exception to this is the \fIoptions\fP section, which defines
|
||||
global options.
|
||||
.TP
|
||||
.SH Example:
|
||||
.RS
|
||||
.nf
|
||||
[options]
|
||||
NoUpgrade = etc/passwd etc/group etc/shadow
|
||||
NoUpgrade = etc/fstab
|
||||
|
||||
Include = /etc/pacman.d/current
|
||||
|
||||
[custom]
|
||||
Server = file:///home/pkgs
|
||||
|
||||
.fi
|
||||
.RE
|
||||
.SH CONFIG: OPTIONS
|
||||
.TP
|
||||
.B "DBPath = path/to/db/dir"
|
||||
Overrides the default location of the toplevel database directory. The default is
|
||||
\fIvar/lib/pacman\fP.
|
||||
.TP
|
||||
.B "CacheDir = path/to/cache/dir"
|
||||
Overrides the default location of the package cache directory. The default is
|
||||
\fIvar/cache/pacman\fP.
|
||||
.TP
|
||||
.B "HoldPkg = <package> [package] ..."
|
||||
If a user tries to \fB--remove\fP a package that's listed in HoldPkg, pacman
|
||||
will ask for confirmation before proceeding.
|
||||
.TP
|
||||
.B "IgnorePkg = <package> [package] ..."
|
||||
Instructs pacman to ignore any upgrades for this package when performing a
|
||||
\fB--sysupgrade\fP.
|
||||
.TP
|
||||
.B "UpgradeDelay = <number>"
|
||||
Upgrade only the packages that are at least <number> days old when
|
||||
performing a \fB--sysupgrade\fP.
|
||||
.TP
|
||||
.B "Include = <path>"
|
||||
Include another config file. This config file can include repositories or
|
||||
general configuration options.
|
||||
.TP
|
||||
.B "ProxyServer = <host|ip>[:port]"
|
||||
If set, pacman will use this proxy server for all ftp/http transfers.
|
||||
.TP
|
||||
.B "XferCommand = /path/to/command %u"
|
||||
If set, pacman will use this external program to download all remote files.
|
||||
All instances of \fB%u\fP will be replaced with the URL to be downloaded. If
|
||||
present, instances of \fB%o\fP will be replaced with the local filename, plus a
|
||||
".part" extension, which allows programs like wget to do file resumes properly.
|
||||
|
||||
This option is useful for users who experience problems with pacman's built-in http/ftp
|
||||
support, or need the more advanced proxy support that comes with utilities like
|
||||
wget.
|
||||
.TP
|
||||
.B "NoPassiveFtp"
|
||||
Disables passive ftp connections when downloading packages. (aka Active Mode)
|
||||
.TP
|
||||
.B "NoUpgrade = <file> [file] ..."
|
||||
All files listed with a \fBNoUpgrade\fP directive will never be touched during a package
|
||||
install/upgrade. \fINote:\fP do not include the leading slash when specifying files.
|
||||
.TP
|
||||
.B "NoExtract = <file> [file] ..."
|
||||
All files listed with a \fBNoExtract\fP directive will never be extracted from
|
||||
a package into the filesystem. This can be useful when you don't want part of
|
||||
a package to be installed. For example, if your httpd root uses an index.php,
|
||||
then you would not want the index.html file to be extracted from the apache
|
||||
package.
|
||||
.TP
|
||||
.B "UseSyslog"
|
||||
Log action messages through syslog(). This will insert pacman log entries into your
|
||||
/var/log/messages or equivalent.
|
||||
.TP
|
||||
.B "LogFile = /path/to/file"
|
||||
Log actions directly to a file, usually /var/log/pacman.log.
|
||||
|
||||
.SH CONFIG: REPOSITORIES
|
||||
Each repository section defines a section name and at least one location where the packages
|
||||
can be found. The section name is defined by the string within square brackets (eg, the two
|
||||
above are 'current' and 'custom'). Locations are defined with the \fIServer\fP directive and
|
||||
follow a URL naming structure. Currently only ftp is supported for remote servers. If you
|
||||
want to use a local directory, you can specify the full path with a 'file://' prefix, as
|
||||
shown above.
|
||||
.SH USING YOUR OWN REPOSITORY
|
||||
Let's say you have a bunch of custom packages in \fI/home/pkgs\fP and their respective FrugalBuild
|
||||
files are all in \fI/var/fst/local\fP. All you need to do is generate a compressed package database
|
||||
in the \fI/home/pkgs\fP directory so pacman can find it when run with --refresh.
|
||||
|
||||
.RS
|
||||
.nf
|
||||
# gensync /var/fst/local /home/pkgs/custom.fdb
|
||||
.fi
|
||||
.RE
|
||||
|
||||
The above command will read all FrugalBuild files in /var/fst/local and generate a compressed
|
||||
database called /home/pkgs/custom.fdb. Note that the database must be of the form
|
||||
\fI{treename}.fdb\fP, where {treename} is the name of the section defined in the
|
||||
configuration file.
|
||||
That's it! Now configure your \fIcustom\fP section in the configuration file as shown in the
|
||||
config example above. Pacman will now use your package repository. If you add new packages to
|
||||
the repository, remember to re-generate the database and use pacman's --refresh option.
|
||||
.SH SEE ALSO
|
||||
\fBmakepkg\fP is the package-building tool that comes with pacman.
|
||||
.SH AUTHOR
|
||||
.nf
|
||||
Judd Vinet <jvinet@zeroflux.org>
|
||||
and the Frugalware developers <frugalware-devel@frugalware.org>
|
||||
.fi
|
Loading…
Reference in New Issue
Block a user