Files
entropy/docs/man/man1/reagent.1
2010-05-09 17:24:29 +02:00

454 lines
12 KiB
Groff

.\" Automatically generated by Pod::Man 2.22 (Pod::Simple 3.07)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings. \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote. \*(C+ will
.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
. ds -- \(*W-
. ds PI pi
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
. ds L" ""
. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
. ds -- \|\(em\|
. ds PI \(*p
. ds L" ``
. ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
. nr % 0
. rr F
.\}
.el \{\
. de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear. Run. Save yourself. No user-serviceable parts.
. \" fudge factors for nroff and troff
.if n \{\
. ds #H 0
. ds #V .8m
. ds #F .3m
. ds #[ \f1
. ds #] \fP
.\}
.if t \{\
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
. ds #V .6m
. ds #F 0
. ds #[ \&
. ds #] \&
.\}
. \" simple accents for nroff and troff
.if n \{\
. ds ' \&
. ds ` \&
. ds ^ \&
. ds , \&
. ds ~ ~
. ds /
.\}
.if t \{\
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
. \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
. \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
. \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
. ds : e
. ds 8 ss
. ds o a
. ds d- d\h'-1'\(ga
. ds D- D\h'-1'\(hy
. ds th \o'bp'
. ds Th \o'LP'
. ds ae ae
. ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "REAGENT 1"
.TH REAGENT 1 "2010-03-30" "perl v5.10.1" "Entropy"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
\&\fBreagent\fR \- Official Sabayon Linux Server-Side Package Management tool
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBreagent\fR [action] [basic_options] [options] [atom | package_file | \f(CW@set\fR] ...
.PP
\&\fBreagent\fR [action] [basic_options] [options] ...
.PP
\&\fBreagent\fR \-\-help
.PP
\&\fBreagent\fR \-\-version
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBreagent\fR is a server-side repository administration tool used to sync Portage
database with Entropy by phisically creating package files and updating Entropy
repository database.
.SH "BASIC_OPTIONS"
.IX Header "BASIC_OPTIONS"
.IP "\fB\-\-help (\-h)\fR" 4
.IX Item "--help (-h)"
this output
.IP "\fB\-\-version\fR" 4
.IX Item "--version"
print version
.IP "\fB\-\-nocolor\fR" 4
.IX Item "--nocolor"
disable colorized output
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fBstatus\fR" 4
.IX Item "status"
show current repositories status
.IP "\fBupdate\fR" 4
.IX Item "update"
scan the System looking for newly compiled packages
.RS 4
.IP "\fB\-\-seekstore\fR" 4
.IX Item "--seekstore"
analyze the Entropy Store directory directly
.IP "\fB\-\-repackage <atoms\fR>" 4
.IX Item "--repackage <atoms>"
repackage the specified atoms
.IP "\fB\-\-noask\fR" 4
.IX Item "--noask"
do not ask anything except critical things
.IP "\fB\-\-atoms <atoms\fR>" 4
.IX Item "--atoms <atoms>"
manage only the specified atoms
.IP "\fB\-\-interactive\fR" 4
.IX Item "--interactive"
run in interactive mode (asking things one by one)
.RE
.RS 4
.RE
.IP "\fBinject <packages\fR>" 4
.IX Item "inject <packages>"
add binary packages to repository w/o affecting scopes (multipackages)
.IP "\fBquery\fR" 4
.IX Item "query"
do some searches into repository databases
.RS 4
.IP "\fBsearch\fR" 4
.IX Item "search"
search packages inside the default repository database
.IP "\fBmatch\fR" 4
.IX Item "match"
match package dependency inside the default repository database
.IP "\fBneeded\fR" 4
.IX Item "needed"
show runtime libraries needed by the provided atoms
.IP "\fBrevdeps\fR" 4
.IX Item "revdeps"
show what packages depend on the provided atoms
.IP "\fBtags\fR" 4
.IX Item "tags"
show packages owning the specified tags
.IP "\fBsets\fR" 4
.IX Item "sets"
search available package sets
.IP "\fBfiles\fR" 4
.IX Item "files"
show files owned by the provided atoms
.IP "\fBbelongs\fR" 4
.IX Item "belongs"
show from what package the provided files belong
.IP "\fBdescription\fR" 4
.IX Item "description"
search packages by description
.IP "\fBeclass\fR" 4
.IX Item "eclass"
search packages using the provided eclasses
.IP "\fBlist\fR" 4
.IX Item "list"
list all the packages in the default repository
.IP "\fBgraph\fR" 4
.IX Item "graph"
show direct depdendencies tree for provided installable atoms
.RS 4
.IP "\fB\-\-complete\fR" 4
.IX Item "--complete"
include system packages, build deps and circularity information
.RE
.RS 4
.RE
.IP "\fBrevgraph\fR" 4
.IX Item "revgraph"
show reverse depdendencies tree for provided installed atoms
.RS 4
.IP "\fB\-\-complete\fR" 4
.IX Item "--complete"
include system packages, build deps and circularity information
.RE
.RS 4
.RE
.IP "\fB\-\-verbose\fR" 4
.IX Item "--verbose"
show more details
.IP "\fB\-\-quiet\fR" 4
.IX Item "--quiet"
print results in a scriptable way
.RE
.RS 4
.RE
.IP "\fBrepo\fR" 4
.IX Item "repo"
manage a repository
.RS 4
.IP "\fB\-\-initialize\fR" 4
.IX Item "--initialize"
(re)initialize the current repository database
.IP "\fBbump\fR" 4
.IX Item "bump"
manually force a revision bump for the current repository database
.RS 4
.IP "\fB\-\-sync\fR" 4
.IX Item "--sync"
synchronize the database
.RE
.RS 4
.RE
.IP "\fBflushback [branches]\fR" 4
.IX Item "flushback [branches]"
flush back old branches packages to current branch
.IP "\fBremove\fR" 4
.IX Item "remove"
remove the provided atoms from the current repository database
.RS 4
.IP "\fB\-\-nodeps\fR" 4
.IX Item "--nodeps"
do not include reverse dependencies
.RE
.RS 4
.RE
.IP "\fBmultiremove\fR" 4
.IX Item "multiremove"
remove the provided injected atoms (all if no atom specified)
.IP "\fBcreate-empty-database\fR" 4
.IX Item "create-empty-database"
create an empty repository database in the provided path
.IP "\fBswitchbranch <from branch\fR <to branch>>" 4
.IX Item "switchbranch <from branch <to branch>>"
switch to the specified branch the repository
.IP "\fBmd5remote\fR" 4
.IX Item "md5remote"
verify remote integrity of the provided atoms (or world)
.IP "\fBbackup\fR" 4
.IX Item "backup"
backup current repository database
.IP "\fBrestore\fR" 4
.IX Item "restore"
restore a previously backed-up repository database
.IP "\fBenable <repo\fR>" 4
.IX Item "enable <repo>"
enable the specified repository
.IP "\fBdisable <repo\fR>" 4
.IX Item "disable <repo>"
disable the specified repository
.IP "\fBpackage-dep <repo\fR [atoms]>" 4
.IX Item "package-dep <repo [atoms]>"
handle packages dependencies
.IP "\fBpackage-tag <repo\fR <tag\-string> [atoms]>" 4
.IX Item "package-tag <repo <tag-string> [atoms]>"
clone a package assigning it an arbitrary tag
.IP "\fBmove <from\fR <to> [atoms]>" 4
.IX Item "move <from <to> [atoms]>"
move packages from a repository to another
.IP "\fBcopy <from\fR <to> [atoms]>" 4
.IX Item "copy <from <to> [atoms]>"
copy packages from a repository to another
.IP "\fBdefault <repo_id\fR>" 4
.IX Item "default <repo_id>"
set the default repository
.RE
.RS 4
.RE
.IP "\fBkey\fR" 4
.IX Item "key"
manage repository digital signatures (OpenGPG)
.RS 4
.IP "\fBcreate [repos]\fR" 4
.IX Item "create [repos]"
create keypair for repositories and sign packages
.IP "\fBdelete [repos]\fR" 4
.IX Item "delete [repos]"
delete keypair (and digital signatures) of repository
.IP "\fBstatus [repos]\fR" 4
.IX Item "status [repos]"
show currently configured keys information for given repositories
.IP "\fBsign [repos]\fR" 4
.IX Item "sign [repos]"
sign (or re-sign) packages in repository using currently set keypair
.IP "\fBimport <repo_id\fR <privkey_path> <pubkey_path>>" 4
.IX Item "import <repo_id <privkey_path> <pubkey_path>>"
import keypair, bind to given repository
.IP "\fBexport-public <repo_id\fR <key_path>>" 4
.IX Item "export-public <repo_id <key_path>>"
export public key of given repository
.RE
.RS 4
.RE
.IP "\fBexport-private <repo_id\fR <key_path>>" 4
.IX Item "export-private <repo_id <key_path>>"
export private key of given repository
.IP "\fBspm\fR" 4
.IX Item "spm"
source package manager functions
.RS 4
.IP "\fBcompile\fR" 4
.IX Item "compile"
compilation function
.RS 4
.IP "\fBcategories\fR" 4
.IX Item "categories"
compile packages belonging to the provided categories
.RS 4
.IP "\fB\-\-list\fR" 4
.IX Item "--list"
just list packages
.RE
.RS 4
.RE
.IP "\fBpkgset\fR" 4
.IX Item "pkgset"
compile packages in provided package set names
.RS 4
.IP "\fB\-\-list\fR" 4
.IX Item "--list"
just list packages
.IP "\fB\-\-rebuild\fR" 4
.IX Item "--rebuild"
rebuild everything
.IP "\fB\-\-dbupdate\fR" 4
.IX Item "--dbupdate"
run database update if all went fine
.IP "\fB\-\-dbsync\fR" 4
.IX Item "--dbsync"
run mirror sync if all went fine
.RE
.RS 4
.RE
.RE
.RS 4
.RE
.IP "\fBorphans\fR" 4
.IX Item "orphans"
scan orphaned packages in \s-1SPM\s0
.IP "\fBnew [categories]\fR" 4
.IX Item "new [categories]"
scan new packages available in \s-1SPM\s0
.RE
.RS 4
.RE
.IP "\fBdeptest\fR" 4
.IX Item "deptest"
look for unsatisfied dependencies
.IP "\fBlibtest\fR" 4
.IX Item "libtest"
look for missing libraries
.RS 4
.IP "\fB\-\-dump\fR" 4
.IX Item "--dump"
dump results to files
.RE
.RS 4
.RE
.IP "\fBpkgtest\fR" 4
.IX Item "pkgtest"
verify the integrity of local package files
.IP "\fBrevdeps\fR" 4
.IX Item "revdeps"
regenerate reverse dependencies metadata
.IP "\fBlibpaths\fR" 4
.IX Item "libpaths"
regenerate the library paths table
.IP "\fBcleanup\fR" 4
.IX Item "cleanup"
remove downloaded packages and clean temp. directories)
.SH "ENVIRONMENT"
.IX Header "ENVIRONMENT"
\&\-\fB\s-1ETP_REPO\s0\fR=valid repository id: on-the-fly switch default Entropy repository.
.SH "BUGS"
.IX Header "BUGS"
Please report bugs to http://bugs.sabayonlinux.org.
.SH "EXIT STATUS"
.IX Header "EXIT STATUS"
\&\fBreagent\fR returns a zero exit status if the called command succeeded. Non zero
is returned in case of failure.
.SH "AUTHOR"
.IX Header "AUTHOR"
Fabio Erculiani <lxnay@sabayon.org>
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIactivator\fR\|(1), \fIequo\fR\|(1)
.SH "POD ERRORS"
.IX Header "POD ERRORS"
Hey! \fBThe above document had some coding errors, which are explained below:\fR
.IP "Around line 304:" 4
.IX Item "Around line 304:"
\&'=item' outside of any '=over'
.IP "Around line 404:" 4
.IX Item "Around line 404:"
You forgot a '=back' before '=head1'