Difference between revisions of "En:Equo"
From Sabayon Wiki
(→Basic Options) |
(→Using Equo - codeboxes. linked to list-article) |
||
| Line 10: | Line 10: | ||
Equo is part of the Entropy package, To install equo follow the instructions on installing entropy available on the [[Entropy#Installing_Entropy|Entropy]] page | Equo is part of the Entropy package, To install equo follow the instructions on installing entropy available on the [[Entropy#Installing_Entropy|Entropy]] page | ||
| − | ==Using Equo== | + | == Using Equo == |
| + | |||
| + | {{main|En:List_Of_Equo_Functions}} | ||
| + | |||
For a complete list of available commands with full descriptions: | For a complete list of available commands with full descriptions: | ||
| − | + | {{Console|<pre class="clear"># equo --help</pre>}} | |
| − | ===Updating package repository=== | + | |
| + | === Updating package repository === | ||
| + | |||
To update the package repository to the latest versions use this command: | To update the package repository to the latest versions use this command: | ||
| − | + | {{Console|<pre class="clear"># equo update</pre>}} | |
| + | |||
| + | === Updating your system === | ||
| − | |||
To update all your packages to the latest available versions use this command: | To update all your packages to the latest available versions use this command: | ||
| − | + | {{Console|<pre class="clear"># equo upgrade --ask</pre>}} | |
| + | |||
| + | === Finding Packages === | ||
| − | |||
Searching for a package can be accomplished by running the equo search command: | Searching for a package can be accomplished by running the equo search command: | ||
| − | + | {{Console|<pre class="clear"># equo search <package name></pre>}} | |
Note that you can use the '''--verbose''' flag in order to get more information about the packages; such as USE flags, CFLAGS, keywords, etc. This also works for '''match''' | Note that you can use the '''--verbose''' flag in order to get more information about the packages; such as USE flags, CFLAGS, keywords, etc. This also works for '''match''' | ||
| − | ===Installing Packages=== | + | === Installing Packages === |
| + | |||
To install a package use the install function, the --ask amendment is optional but recommended. | To install a package use the install function, the --ask amendment is optional but recommended. | ||
| − | + | {{Console|<pre class="clear"># equo install <package> --ask</pre>}} | |
| − | ===Removing Packages=== | + | |
| + | === Removing Packages === | ||
| + | |||
To remove a package use the remove function as shown below: | To remove a package use the remove function as shown below: | ||
| − | + | {{Console|<pre class="clear"># equo remove <package></pre>}} | |
| − | ===Cleanup downloaded packages=== | + | |
| + | === Cleanup downloaded packages === | ||
| + | |||
Every now and then you want to cleanup the packages that Entropy downloaded. Once installed the downloaded packages can be removed: | Every now and then you want to cleanup the packages that Entropy downloaded. Once installed the downloaded packages can be removed: | ||
| − | + | {{Console|<pre class="clear"># equo cleanup</pre>}} | |
| + | |||
[[Category:Entropy|EquoEn]] | [[Category:Entropy|EquoEn]] | ||
Revision as of 23:04, 4 April 2013
Under Construction
This article is currently under construction and may be incomplete or change frequently.
This article is currently under construction and may be incomplete or change frequently.
Contents
About Equo
Equo is the command line client side application for the Entropy system. It is capable of installing, removing and updating packages, resolving dependences, reverse dependency handling and configuration file handling and that's just to start with.
Installing Equo
Equo is part of the Entropy package, To install equo follow the instructions on installing entropy available on the Entropy page
Using Equo
For more information see the En:List_Of_Equo_Functions main entry
For a complete list of available commands with full descriptions:
# equo --help
Updating package repository
To update the package repository to the latest versions use this command:
# equo update
Updating your system
To update all your packages to the latest available versions use this command:
# equo upgrade --ask
Finding Packages
Searching for a package can be accomplished by running the equo search command:
# equo search <package name>
Note that you can use the --verbose flag in order to get more information about the packages; such as USE flags, CFLAGS, keywords, etc. This also works for match
Installing Packages
To install a package use the install function, the --ask amendment is optional but recommended.
# equo install <package> --ask
Removing Packages
To remove a package use the remove function as shown below:
# equo remove <package>
Cleanup downloaded packages
Every now and then you want to cleanup the packages that Entropy downloaded. Once installed the downloaded packages can be removed:
# equo cleanup
Full 'equo --help --verbose'
For easy reference output of equo --help --verbose pasted here in a nice, easier to read wiki format.
Basic Options
--help this output --version print version --nocolor disable colorized output
Application Options
update update configured repositories
--force force sync regardless repositories status
repo manage your repositories
enable enable given repository
disable disable given repository
add <string> add repository (pass repository string)
remove <id> remove repository
mirrorsort <id> reorder mirrors basing on response time
merge [sources] <dest> merge content of source repos to dest [for developers]
--conflicts also remove dependency conflicts during merge
notice [repos] repository notice board reader
status show respositories status
search search packages in repositories
match match a package in repositories
--multimatch return all the possible matches
--installed match inside installed packages repository
--multirepo return matches from every repository
--showrepo print repository information (w/--quiet)
--showdesc print description too (w/--quiet)
hop <branch> upgrade your distribution to a new release (branch)
upgrade update system with the latest available packages
--ask ask before making any changes
--fetch just download packages
--pretend only show what would be done
--verbose show more details about what is going on
--replay reinstall all the packages and their dependencies
--empty same as --replay
--resume resume previously interrupted operations
--skipfirst used with --resume, makes the first package to be skipped
--multifetch download multiple packages in parallel (default 3)
--multifetch=N download N packages in parallel (max 10)
security security infrastructure functions
oscheck verify installed files using stored checksums
--mtime consider mtime instead of SHA256 (false positives ahead)
--assimilate update hashes and mtime (useful after editing config files)
--reinstall reinstall faulty packages
--quiet show less details (useful for scripting)
--verbose also list removed files
update download the latest Security Advisories
--force force download even if already up-to-date
list list all the available Security Advisories
--affected list only affected
--unaffected list only unaffected
info show information about provided advisories identifiers
install automatically install all the available security updates
--ask ask before making any changes
--fetch just download packages
--pretend just show what would be done
--quiet show less details (useful for scripting)
install install atoms or binary packages
--ask ask before making any changes
--pretend just show what would be done
--fetch just download packages without doing the install
--nodeps do not pull in any dependency
--bdeps also pull in build-time dependencies
--resume resume previously interrupted operations
--skipfirst used with --resume, makes the first package in queue to be skipped
--clean remove downloaded packages after being used
--empty pull all the dependencies in, regardless their state
--relaxed calm down dependencies resolution algorithm (might be risky)
--deep makes dependency rules stricter
--verbose show more details about what is going on
--configfiles makes old configuration files to be removed
--multifetch download multiple packages in parallel (default 3)
--multifetch=N download N packages in parallel (max 10)
source download atoms source code
--ask ask before making any changes
--pretend just show what would be done
--nodeps do not pull in any dependency
--relaxed calm down dependencies resolution algorithm (might be risky)
--savehere save sources in current working directory
fetch just download packages without doing the install
--ask ask before making any changes
--pretend just show what would be done
--nodeps do not pull in any dependency
--relaxed calm down dependencies resolution algorithm (might be risky)
--multifetch download multiple packages in parallel (default 3)
--multifetch=N download N packages in parallel (max 10)
remove remove one or more packages
--ask ask before making any changes
--pretend just show what would be done
--nodeps do not pull in any dependency
--deep also pull unused dependencies where reverse deps list is empty
--empty when used with --deep, helps the removal of virtual packages
--configfiles makes configuration files to be removed
--force-system dangerous: forces system packages removal, do not use this!
--resume resume previously interrupted operations
mask mask one or more packages
--ask ask before making any changes
--pretend just show what would be done
unmask unmask one or more packages
--ask ask before making any changes
--pretend just show what would be done
config configure one or more installed packages
--ask ask before making any changes
--pretend just show what would be done
deptest look for unsatisfied dependencies
--quiet show less details (useful for scripting)
--ask ask before making any changes
--pretend just show what would be done
unusedpackages look for unused packages (pay attention)
--quiet show less details (useful for scripting)
--sortbysize sort packages by disk size
libtest look for missing libraries
--dump dump results to files
--listfiles print broken files to stdout
--quiet show less details (useful for scripting)
--ask ask before making any changes
--pretend just show what would be done
conf configuration files update tool
info show configuration files to be updated
update run the configuration files update function
query do misc queries on repository and local databases
belongs search from what package a file belongs
changelog show packages changelog
revdeps search what packages depend on the provided atoms
description search packages by description
files show files owned by the provided atoms
installed search a package into the local database
license show packages owning the provided licenses
list list packages based on the chosen parameter below
installed list installed packages
available [repos] list available packages
mimetype search packages able to handle given mimetypes
--installed search among installed packages
associate associate given file paths to applications able to read them
--installed search among installed packages
needed show runtime libraries needed by the provided atoms
orphans search files that do not belong to any package
removal show the removal tree for the specified atoms
required show atoms needing the provided libraries
sets search available package sets
slot show packages owning the provided slot
tags show packages owning the provided tags
graph show direct depdendencies tree for provided installable atoms
--complete include system packages, build deps and circularity information
revgraph show reverse depdendencies tree for provided installed atoms
--complete include system packages, build deps and circularity information
--verbose show more details
--quiet print results in a scriptable way
Extended Options
smart handles extended functionalities
application make a smart application for the provided atoms (experimental)
package make a smart package for the provided atoms (multiple packages into one file)
quickpkg recreate an Entropy package from your System
--savedir save new packages into the specified directory
inflate convert provided Source Package Manager package files into Entropy packages
--savedir save new packages into the specified directory
deflate convert provided Entropy packages into Source Package Manager ones
--savedir save new packages into the specified directory
extract extract Entropy metadata from provided Entropy package files
--savedir save new metadata into the specified directory
rescue contains System rescue tools
check check installed packages repository for errors
vacuum remove installed packages repository internal indexes to save disk space
generate generate installed packages database using Source Package Manager repositories
resurrect generate installed packages database using files on the system [last hope]
spmuids regenerate SPM UIDs map (SPM <-> Entropy packages)
spmsync makes Entropy aware of your Source Package Manager updated packages
backup backup the current Entropy installed packages database
restore restore a previously backed up Entropy installed packages database
community handles community-side features
repos community repositories management functions
update scan the System looking for newly compiled packages
--seekstore analyze the Entropy Store directory directly
--repackage <atoms> repackage the specified atoms
--noask do not ask anything except critical things
--atoms <atoms> manage only the specified atoms
--interactive run in interactive mode (asking things one by one)
inject <packages> add binary packages to repository w/o affecting scopes (multipackages)
mirrors community repositories mirrors management functions
sync sync packages, database and also do some tidy
--noask do not ask anything except critical things
--syncall sync all the configured repositories
packages-sync sync packages across primary mirrors
--ask ask before making any changes
--pretend only show what would be done
--syncall sync all the configured repositories
--do-packages-check also verify packages integrity
repo-sync sync the current repository database across primary mirrors
--syncall sync all the configured repositories
repo-lock lock the current repository database (server-side)
repo-unlock unlock the current repository database (server-side)
repo-download-lock lock the current repository database (client-side)
repo-download-unlock unlock the current repository database (client-side)
repo-lock-status show current lock status
tidy remove binary packages not in repositories and expired
vacuum clean unavaiable packages from mirrors (similar to tidy, but more nazi)
--days=<days> expiration days [default is: 0, dangerous!]
repo manage a repository
--initialize (re)initialize the current repository database
--empty do not refill database using packages on mirrors
--repo=<repo> (re)create the database for the specified repository
bump manually force a revision bump for the current repository database
--sync synchronize the database
flushback [branches] flush back old branches packages to current branch
remove remove the provided atoms from the current repository database
multiremove remove the provided injected atoms (all if no atom specified)
create-empty-database create an empty repository database in the provided path
switchbranch <from branch> <to branch> switch to the specified branch the provided atoms (or world)
md5remote verify remote integrity of the provided atoms (or world)
backup backup current repository database
restore restore a previously backed-up repository database
spmuids regenerate SPM UIDs map (SPM <-> Entropy packages)
enable <repo> enable the specified repository
disable <repo> disable the specified repository
status <repo> show the current Server Interface status
package-dep-check <repo> [atoms] check packages in repository for missing dependencies
package-dep <repo> [atoms] handle packages dependencies
package-tag <repo> <tag-string> [atoms] clone a package inside a repository assigning it an arbitrary tag
move <from> <to> [atoms] move packages from a repository to another
--deps pulls dependencies in
copy <from> <to> [atoms] copy packages from a repository to another
--deps pulls dependencies in
default <repo_id> set the default repository
key manage repository digital signatures (OpenGPG)
create [repos] create keypair for repositories and sign packages
delete [repos] delete keypair (and digital signatures) of repository
status [repos] show currently configured keys information for given repositories
sign [repos] sign (or re-sign) packages in repository using currently set keypair
import <repo_id> <privkey_path> <pubkey_path> import keypair, bind to given repository
export-public <repo_id> <key_path> export public key of given repository
export-private <repo_id> <key_path> export private key of given repository
query do some searches into community repository databases
belongs show from what package the provided files belong
changelog show packages changelog
revdeps show what packages depend on the provided atoms
description search packages by description
files show files owned by the provided atoms
list list all the packages in the default repository
needed show runtime libraries needed by the provided atoms
search search packages inside the default repository database
sets search available package sets
tags show packages owning the specified tags
revisions show installed packages owning the specified revisions
--verbose show more details
--quiet print results in a scriptable way
spm source package manager functions
compile compilation function
categories compile packages belonging to the provided categories
--list just list packages
--nooldslots do not pull old package slots
pkgset compile packages in provided package set names
--list just list packages
--rebuild rebuild everything
--dbupdate run database update if all went fine
--dbsync run mirror sync if all went fine
orphans scan orphaned packages on SPM
notice notice board handling functions
add add a news item to the notice board
remove remove a news item from the notice board
read read the current notice board
deptest look for unsatisfied dependencies across community repositories
pkgtest verify the integrity of local package files
ugc handles User Generated Content features
login <repository> login against a specified repository
logout <repository> logout from a specified repository
--force force action
documents <repository> manage package documents for the selected repository (comments, files, videos)
get <pkgkey> get available documents for the specified package key (example: x11-libs/qt)
add <pkgkey> add a new document to the specified package key (example: x11-libs/qt)
remove <docs ids> remove documents from database using their identifiers
vote <repository> manage package votes for the selected repository
get <pkgkey> get vote for the specified package key (example: x11-libs/qt)
add <pkgkey> add vote for the specified package key (example: x11-libs/qt)
cache handles Entropy cache
clean clean Entropy cache
--verbose show more details
--quiet print results in a scriptable way
cleanup remove downloaded packages and clean temp. directories
--info show system information
