Files
entropy/docs/man/man1/reagent.1
2010-01-02 17:11:56 +01:00

448 lines
12 KiB
Groff

.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.37
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.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. | will give a
.\" real vertical bar. \*(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-|\(bv\*(Tr
.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\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
. nr % 0
. rr F
.\}
.\"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" 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-01-02" "perl v5.8.8" "Entropy"
.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 "\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 "\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 "\fBdatabase\fR" 4
.IX Item "database"
repository database functions
.RS 4
.IP "\fB\-\-initialize\fR" 4
.IX Item "--initialize"
(re)initialize the current repository database
.RS 4
.IP "\fB\-\-empty\fR" 4
.IX Item "--empty"
do not refill database using packages on mirrors
.IP "\fB\-\-repo=<repo\fR>" 4
.IX Item "--repo=<repo>"
(re)create the database for the specified repository
.RE
.RS 4
.RE
.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
.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
.RE
.RS 4
.RE
.IP "\fBrepo\fR" 4
.IX Item "repo"
manage a repository
.RS 4
.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 "\fBstatus <repo\fR>" 4
.IX Item "status <repo>"
show the current Server Interface status
.IP "\fBmanual-deps <repo\fR [atoms]>" 4
.IX Item "manual-deps <repo [atoms]>"
handle packages manual 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
.RE
.IP "\fBspm\fR"
.IX Item "spm"
source package manager functions
.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 on \s-1SPM\s0
.RE
.IP "\fBdeptest\fR"
.IX Item "deptest"
look for unsatisfied dependencies
.RE
.IP "\fBlibtest\fR"
.IX Item "libtest"
look for missing libraries
.IP "\fB\-\-dump\fR" 4
.IX Item "--dump"
dump results to files
.RE
.IP "\fBpkgtest\fR"
.IX Item "pkgtest"
verify the integrity of local package files
.RE
.IP "\fBrevdeps\fR"
.IX Item "revdeps"
regenerate reverse dependencies metadata
.RE
.IP "\fBlibpaths\fR"
.IX Item "libpaths"
regenerate the library paths table
.RE
.IP "\fBcleanup\fR"
.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)