Difference between revisions of "En:Equo"

From Sabayon Wiki
Jump to: navigation, search
(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:
# equo --help --verbose
+
{{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:
# equo update
+
{{Console|<pre class="clear"># equo update</pre>}}
 +
 
 +
=== Updating your system ===
  
===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:
# equo upgrade --ask
+
{{Console|<pre class="clear"># equo upgrade --ask</pre>}}
 +
 
 +
=== Finding Packages ===
  
===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:
# equo search <package name>
+
{{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.  
# equo install <package> --ask
+
{{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:
# equo remove <package>
+
{{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:
# equo cleanup
+
{{Console|<pre class="clear"># equo cleanup</pre>}}
 +
 
 
[[Category:Entropy|EquoEn]]
 
[[Category:Entropy|EquoEn]]
  

Revision as of 23:04, 4 April 2013

i18n: ca de en es it ru tr
UnderConstruction.png
Under Construction
This article is currently under construction and may be incomplete or change frequently.

About Equo

Equo in Action

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