EQUO(1)

NAME
equo - Official Sabayon Linux Package Manager Client

SYNOPSIS
equo [action] [basic_options] [options|extended_options] [atom | package_file | @set] ...

equo [action] [basic_options] [options|extended_options] ...

equo --info

equo --help

equo --version

DESCRIPTION
equo is the definitive (rofl)... scratch it. equo is the official command-line interface to the Entropy framework. Primarily used to ease packages management on Gentoo-based, Entropy-enabled distributions.

With equo you can easily install and remove any application inside available and enabled repositories: it's a binary package manager which brings the best from apt, yum and rpm, keeping 100% backward Portage (see 'man emerge') compatibility. Being Entropy a framework means that it's not just ended here.

For example, through equo you can build your own software repository (called Community Repository), do searches, keep your system secure, download packages' source code, sanity check your system, see and be part of the User Generated Content produced by other users.

BASIC_OPTIONS

[1] --help
    this output

[1] --version
    print version

[1] --nocolor
    disable colorized output

[1] --color
    force colorized output

[1] --bashcomp
    print a bash completion script to stdout

OPTIONS

[1] update
    update configured repositories

    [2] --force
        force sync regardless repositories status

[1] repo
    manage your repositories

    [2] enable
        enable given repository

    [2] disable
        disable given repository

    [2] add <string>
        add repository (pass repository string)

    [2] remove <id>
        remove repository

    [2] mirrorsort <id>
        reorder mirrors basing on response time

    [2] merge [sources] <dest>
        merge content of source repos to dest [for developers]

        [3] --conflicts
            also remove dependency conflicts during merge

[1] notice [repos]
    repository notice board reader

[1] status
    show respositories status

[1] search
    search packages in repositories

[1] match
    match a package in repositories

    [2] --multimatch
        return all the possible matches

    [2] --installed
        match inside installed packages repository

    [2] --multirepo
        return matches from every repository

    [2] --showrepo
        print repository information (w/--quiet)

    [2] --showdesc
        print description too (w/--quiet)

[1] hop <branch>
    upgrade your distribution to a new release (branch)

[1] upgrade
    update system with the latest available packages

    [2] --ask
        ask before making any changes

    [2] --fetch
        just download packages

    [2] --pretend
        only show what would be done

    [2] --verbose
        show more details about what is going on

    [2] --replay
        reinstall all the packages and their dependencies

    [2] --empty
        same as --replay

    [2] --resume
        resume previously interrupted operations

    [2] --skipfirst
        used with --resume, makes the first package to be skipped

    [2] --multifetch
        download multiple packages in parallel (default 3)

    [2] --multifetch=N
        download N packages in parallel (max 10)

[1] security
    security infrastructure functions

    [2] oscheck
        verify installed files using stored checksums

        [3] --mtime
            consider mtime instead of SHA256 (false positives ahead)

        [3] --assimilate
            update hashes and mtime (useful after editing config files)

        [3] --reinstall
            reinstall faulty packages

        [3] --quiet
            show less details (useful for scripting)

        [3] --verbose
            also list removed files

    [2] update
        download the latest Security Advisories

        [3] --force
            force download even if already up-to-date

    [2] list
        list all the available Security Advisories

        [3] --affected
            list only affected

        [3] --unaffected
            list only unaffected

    [2] info
        show information about provided advisories identifiers

    [2] install
        automatically install all the available security updates

        [3] --ask
            ask before making any changes

        [3] --fetch
            just download packages

        [3] --pretend
            just show what would be done

        [3] --quiet
            show less details (useful for scripting)

[1] install
    install atoms or binary packages

    [2] --ask
        ask before making any changes

    [2] --pretend
        just show what would be done

    [2] --fetch
        just download packages without doing the install

    [2] --nodeps
        do not pull in any dependency

    [2] --bdeps
        also pull in build-time dependencies

    [2] --resume
        resume previously interrupted operations

    [2] --skipfirst
        used with --resume, makes the first package in queue to be skipped

    [2] --clean
        remove downloaded packages after being used

    [2] --empty
        pull all the dependencies in, regardless their state

    [2] --relaxed
        calm down dependencies resolution algorithm (might be risky)

    [2] --deep
        makes dependency rules stricter

    [2] --verbose
        show more details about what is going on

    [2] --configfiles
        makes old configuration files to be removed

    [2] --multifetch
        download multiple packages in parallel (default 3)

    [2] --multifetch=N
        download N packages in parallel (max 10)

[1] source
    download atoms source code

    [2] --ask
        ask before making any changes

    [2] --pretend
        just show what would be done

    [2] --nodeps
        do not pull in any dependency

    [2] --relaxed
        calm down dependencies resolution algorithm (might be risky)

    [2] --savehere
        save sources in current working directory

[1] fetch
    just download packages without doing the install

    [2] --ask
        ask before making any changes

    [2] --pretend
        just show what would be done

    [2] --nodeps
        do not pull in any dependency

    [2] --relaxed
        calm down dependencies resolution algorithm (might be risky)

    [2] --multifetch
        download multiple packages in parallel (default 3)

    [2] --multifetch=N
        download N packages in parallel (max 10)

[1] remove
    remove one or more packages

    [2] --ask
        ask before making any changes

    [2] --pretend
        just show what would be done

    [2] --nodeps
        do not pull in any dependency

    [2] --deep
        also pull unused dependencies where reverse deps list is empty

    [2] --empty
        when used with --deep, helps the removal of virtual packages

    [2] --configfiles
        makes configuration files to be removed

    [2] --force-system
        dangerous: forces system packages removal, do not use this!

    [2] --resume
        resume previously interrupted operations

[1] mask
    mask one or more packages

    [2] --ask
        ask before making any changes

    [2] --pretend
        just show what would be done

[1] unmask
    unmask one or more packages

    [2] --ask
        ask before making any changes

    [2] --pretend
        just show what would be done

[1] config
    configure one or more installed packages

    [2] --ask
        ask before making any changes

    [2] --pretend
        just show what would be done

[1] deptest
    look for unsatisfied dependencies

    [2] --quiet
        show less details (useful for scripting)

    [2] --ask
        ask before making any changes

    [2] --pretend
        just show what would be done

[1] unusedpackages
    look for unused packages (pay attention)

    [2] --quiet
        show less details (useful for scripting)

    [2] --sortbysize
        sort packages by disk size

[1] libtest
    look for missing libraries

    [2] --dump
        dump results to files

    [2] --listfiles
        print broken files to stdout

    [2] --quiet
        show less details (useful for scripting)

    [2] --ask
        ask before making any changes

    [2] --pretend
        just show what would be done

[1] conf
    configuration files update tool

    [2] info
        show configuration files to be updated

    [2] update
        run the configuration files update function

[1] query
    do misc queries on repository and local databases

    [2] belongs
        search from what package a file belongs

    [2] changelog
        show packages changelog

    [2] revdeps
        search what packages depend on the provided atoms

    [2] description
        search packages by description

    [2] files
        show files owned by the provided atoms

    [2] installed
        search a package into the local database

    [2] license
        show packages owning the provided licenses

    [2] list
        list packages based on the chosen parameter below

        [3] installed
            list installed packages

            [4] --by-user
                only packages installed by user

        [3] available [repos]
            list available packages

    [2] mimetype
        search packages able to handle given mimetypes

        [3] --installed
            search among installed packages

    [2] associate
        associate given file paths to applications able to read them

        [3] --installed
            search among installed packages

    [2] needed
        show runtime libraries needed by the provided atoms

    [2] orphans
        search files that do not belong to any package

    [2] removal
        show the removal tree for the specified atoms

    [2] required
        show atoms needing the provided libraries

    [2] sets
        search available package sets

    [2] slot
        show packages owning the provided slot

    [2] tags
        show packages owning the provided tags

    [2] graph
        show direct depdendencies tree for provided installable atoms

        [3] --complete
            include system packages, build deps and circularity information

    [2] revgraph
        show reverse depdendencies tree for provided installed atoms

        [3] --complete
            include system packages, build deps and circularity information

    [2] --verbose
        show more details

    [2] --quiet
        print results in a scriptable way

EXTENDED_OPTIONS

[1] smart
    handles extended functionalities

    [2] application
        make a smart application for the provided atoms (experimental)

    [2] package
        make a smart package for the provided atoms (multiple packages into one file)

    [2] quickpkg
        recreate an Entropy package from your System

        [3] --savedir
            save new packages into the specified directory

    [2] inflate
        convert provided Source Package Manager package files into Entropy packages

        [3] --savedir
            save new packages into the specified directory

    [2] deflate
        convert provided Entropy packages into Source Package Manager ones

        [3] --savedir
            save new packages into the specified directory

    [2] extract
        extract Entropy metadata from provided Entropy package files

        [3] --savedir
            save new metadata into the specified directory

[1] rescue
    contains System rescue tools

    [2] check
        check installed packages repository for errors

    [2] vacuum
        remove installed packages repository internal indexes to save disk space

    [2] generate
        generate installed packages database using Source Package Manager repositories

    [2] resurrect
        generate installed packages database using files on the system [last hope]

    [2] spmuids
        regenerate SPM UIDs map (SPM <-> Entropy packages)

    [2] spmsync
        makes Entropy aware of your Source Package Manager updated packages

    [2] backup
        backup the current Entropy installed packages database

    [2] restore
        restore a previously backed up Entropy installed packages database

[1] ugc
    handles User Generated Content features

    [2] login <repository>
        login against a specified repository

    [2] logout <repository>
        logout from a specified repository

        [3] --force
            force action

    [2] documents <repository>
        manage package documents for the selected repository (comments, files, videos)

        [3] get <pkgkey>
            get available documents for the specified package key (example: x11-libs/qt)

        [3] add <pkgkey>
            add a new document to the specified package key (example: x11-libs/qt)

        [3] remove <docs ids>
            remove documents from database using their identifiers

    [2] vote <repository>
        manage package votes for the selected repository

        [3] get <pkgkey>
            get vote for the specified package key (example: x11-libs/qt)

        [3] add <pkgkey>
            add vote for the specified package key (example: x11-libs/qt)

[1] cache
    handles Entropy cache

    [2] clean
        clean Entropy cache

    [2] --verbose
        show more details

    [2] --quiet
        print results in a scriptable way

[1] cleanup
    remove downloaded packages and clean temp. directories

[1] --info
    show system information

ENVIRONMENT
ETP_NOCACHE=1: if set, all the Entropy framework will never use its internal on-disk cache.

FORCE_EAPI=N: if set to 1, 2 or 3 and used with 'equo update', Entropy repository synchronized will be force to use the provided EAPI to update repositories.

ACCEPT_LICENSE=license_id1:license_id2:...: this is a way to avoid equo asking to accept specific licenses.

ETP_NO_COLOR=1: disable entropy coloured output.

BUGS
Please report bugs to http://bugs.sabayonlinux.org. equo has a nice bug-reporting feature: whenever a valid exception occurs, it asks the user to automatically submit the issue. WARNING: to do efficient bug squashing, some hardware specs are going to be collected, ask wrote before submitting any data. No personal data is going to be uploaded and your report will be kept private.

EXAMPLES
 work in progress

EXIT STATUS
equo returns a zero exit status if the called command succeeded. Non zero is returned in case of failure.

AUTHOR
Fabio Erculiani <lxnay@sabayon.org>

SEE ALSO
reagent(1), activator(1)