repository.eselect(15)

NAME
repository.eselect - Manage repos.conf via eselect

SYNOPSIS
eselect repository [help|usage|version]
eselect repository add name sync-type sync-uri
eselect repository disable [-f] (name|index)
eselect repository enable (name|index)
eselect repository list [-i]
eselect repository remove [-f] (name|index)

DESCRIPTION
repository.eselect is an eselect module for manipulating /etc/portage/repos.conf entries to third party repositories (also known as overlays). This supersedes the need for app-admin/layman to list, configure, and handle synchronizations of alternate repositories except for those which the package manager does not (eg. mercurial, bazaar and g-sorcery in portage).

ACTION: ADD
Add a custom repository

eselect repository add name sync-type sync-uri

Parameters:

name
    Name of the repository to add

sync-type
    Syncer to use (e.g. git, rsync, svn...)

sync-uri
    Sync URI

ACTION: CREATE
Create a local repository, initialize it with some boilerplate and add it to repos.conf

eselect repository create name [path]

Parameters:

name
    Name of the repository to create

path
    Directory to create the repository in. If not specified, defaults to a subdirectory of storage dir matching name

sync-uri
    Sync URI

ACTION: DISABLE
Disable specified repositories without removing their contents

eselect repository disable [-f] (name|index)

Parameters:

-f  Force potentially dangerous removals. Required for unregistered repositories and those without sync attributes.

name
    Names of repositories to disable

index
    Numeric index of the repository (from 'list' command)

ACTION: ENABLE
Enable the specified repositories from the list

eselect repository enable (name|index)

Parameters:

name
    Names of repositories to enable

index
    Numeric index of the repository (from 'list' command)

ACTION: LIST
List all repositories. The repositories in the listing are suffixed by a symbol, that indicates their current state.

eselect repository list [-i]

Parameters:

-i  Only list installed

State suffixes:

*   Repository is enabled

#   Repositorys sync information is out of date and needs to be updated (via disable/enable) or is customized

@   Repository is not listed by name in the official, published list

ACTION: REMOVE
Remove installed repositories along with their contents

eselect repository remove [-f] (name|index)

Parameters:

-f  Force potentially dangerous removals. Required for unregistered repositories and those without sync attributes.

name
    Names of repositories to remove

index
    Numeric index of the repository (from 'list' command)

EXAMPLES
Listing registered repositories

        # eselect repository list
        Available repositories:
          [1]   foo
          [2]   bar
          [3]   baz
          [4]   cross #
          [5]   good *
          [6]   my_overlay @
Add registered repositories

        # eselect repository enable foo bar baz
Add unregistered repositories

        # eselect repository add test git https://github.com/test/test.git
Disable repositories without removing contents

        # eselect repository disable foo bar baz
Disable repositories and remove contents

        # eselect repository remove foo bar baz

FILES

/etc/eselect/repository.conf
    Configuration for repository.eselect

SEE ALSO
eselect(1), portage(5)