Difference between revisions of "En:Equo"

From Sabayon Wiki
Jump to: navigation, search
(Basic Options)
 
(removed the construction-box)
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
{{I18n| [[Ca:Equo|ca]] [[De:Equo|de]] [[En:Equo|en]] [[Es:Equo|es]] [[It:Equo|it]] [[Ru:Equo|ru]] [[Tr:Equo|tr]]}}
 
{{I18n| [[Ca:Equo|ca]] [[De:Equo|de]] [[En:Equo|en]] [[Es:Equo|es]] [[It:Equo|it]] [[Ru:Equo|ru]] [[Tr:Equo|tr]]}}
  
{{Construction}}
 
  
==About Equo==
+
== About Equo ==
 +
 
 
[[Image:Equo--help_ouput.png|thumb|400px|Equo in Action]]
 
[[Image:Equo--help_ouput.png|thumb|400px|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.
 
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==
+
== Installing Equo ==
 +
 
 
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===
+
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
+
[[Category:Entropy|EquoEn]]
+
  
==Full 'equo --help --verbose'==
+
=== Removing Packages ===
  
''For easy reference'' output of '''equo --help --verbose''' pasted here in a nice, easier to read wiki format.
+
To remove a package use the remove function as shown below:
 
+
{{Console|<pre class="clear"># equo remove <package></pre>}}
===Basic Options===
+
  
'''--help'''        this output
+
=== Cleanup downloaded packages ===
'''--version'''        print version
+
'''--nocolor'''        disable colorized output
+
  
===Application Options===
+
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>}}
'''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
+
  
 
[[Category:Entropy|EquoEn]]
 
[[Category:Entropy|EquoEn]]

Latest revision as of 23:06, 4 April 2013

i18n: ca de en es it ru tr


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