Files
entropy/docs/man/man1/reagent.1
T
Fabio Erculiani f93a86208b entropy.server: implement branch flushback logic
Generally, when starting a new branch packages are not copied over
to avoid wasting disk space. So, old packages will be still pulled
in from old branch directories (under packages/). This commit adds
a function that automatically flush back old-branch packages into
the current one.
Let's say we have just bumped our repo from branch 1 to branch 2.
We have 3 packages into it that are still placed inside /packages/1.
Everything works until we decide to drop support from branch 1, in
this case, we would have to rebuild all these packages wasting a lot
of time. With "flushback" this is done automatically without touching
packages integrity.
2009-05-15 10:11:30 +02:00

388 lines
10 KiB
Groff

.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.35
.\"
.\" 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 "2009-05-15" "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
.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 "\fBdepends\fR" 4
.IX Item "depends"
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 "\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 "\fBmd5check\fR" 4
.IX Item "md5check"
verify integrity of the provided atoms (or world)
.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 "\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 on \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
.IP "\fBdepends\fR" 4
.IX Item "depends"
regenerate the depends 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)