opkg(5)

NAME
opkg.conf - opkg configuration file

DESCRIPTION
This file contains default options for opkg. Each line contains a single option which is exactly the same as a normal command line option for opkg except for the leading dashes which are not used here. Comments are allowed by starting a line with a hash sign ("#").

There can be multiple configuration files. Repositories can be placed in separate *.conf files. A repository configuration file needs only a src line.

A opkg.conf file is not needed if repositories are not being used to obtain packages and if the packages are expected to install in "/".

FILES
/usr/etc/*.conf

USAGE
Outlined is an example of how to set specific options

    option autoremove 1
    option check_signature 1
    option signature_type gpg
    dest root /
    arch i386 1
    src/gz base http://my.package.server/path/to/my/base/repo
    src/gz nightly http://my.package.server/path/to/my/snapshot/repo

REPOSITORY CONFIGURATION
The opkg repository configuration consists of three parts.

The repository type, the repository name, and the repository location. The repository type is used to indicate what format the repository will take. src will take the form of an uncompress repository list, while src/gz will take the form of a gzip compress repository list.

The repository name is a descriptive name used to identify a particular repository. For instance base may refer to a basic repository containing packages used for generic maintanace. A repository named nightly may contain packages from some daily build system.

The third part consists of the repository location. This must point to the top directory containing the Packages index file. The repository location may refer to a local directory on the system with the prefix file://, or to a webserver with http://https://, or to an FTP server with ftp://.

OPTIONS

arch
    Registers a given architecture with a given priorty. The number specifies a priority index which is used by opkg to determine which package to prefer in case it is available in multiple architectures.

autoremove
    Removes packages that where installed automatically in order to satisfy dependencies (default is 0).

cache_dir
    Specifies the cache directory.

cache_local_files
    For local repositories (file://), a symlink of the file is created in the cache directory rather than copying the file directly (default is 0)

check_pkg_signature
    Performs a signature check against a package. The signature file should be next to the package (default is 0).

check_signature
    Performs a signature check against the package index. The signature file should be next to the package index (default is 0)

check_x509_path
    Validates the x509 certificate all the way back to the Certificate Authority (default is 0)

combine
    Combines upgrade and install operations, this may be needed to resolve dependency issues. Only available for the internal solver backend (default is 0).

connect_timeout_ms (CURL)
    The maximum amount of time allowed for a connection initalization to take (default is 300 seconds).

dest
    Registers a given destination with a given path. If no dest is specified root is specified automatically to /.

download_only
    No action -- download only (default is 0).

follow_location (CURL)
    Follows any "Location:" header that the server sends as part of the HTTP header (default is 0).

force_depends
    Install/remove despite failed dependencies (default is 0).

force_downgrade
    Allow opkg to downgrade a package (default is 0).

force_maintainer
    Overwrite existing conffile's (default is 0).

force_overwrite
    Overwrites files from other packages (default is 0).

force_postinstall
    Run postinstall scripts even in offline mode (default is 0).

force-checksum
    Don't fail on checksum mismatches (default is 0).

force_reinstall
    Reinstalls the package(s) (default is 0).

force_space
    Disables free space checks (default is 0).

ftp_explicit_ssl (CURL)
    Forces CURL to establish a FTP connection over SSL (default is 0).

ftp_proxy (CURL/WGET)
    Specifies the FTP Proxy.

gpg_dir
    Specifies the GPG directory containing the GPG keyring.

gpg_trust_level
    Specifies the GPG trusted level. The Default is TrustOnly.
    TrustOnly - Trust only package signatures with a trust level of Full or Ultimate
    TrustAny - Trust any package with a valid signature
    Note: Any file signed with a GPG that is specified as trust level NEVER will NOT be trusted

http_auth (CURL)
    Specifies the HTTP username/password in the format "[username]:[password]".

http_proxy (CURL/WGET)
    Specifies the HTTP proxy address in the format "<url:port>".

https_proxy (CURL)
    Specifies the HTTPS proxy address in the format "<url:port>".

ignore_maintainer
    Ignores changes to files listed as conffile's during a package upgrade (default is 0).

info_dir
    Specifies the directory used to store packages information.

lists_dir
    Specifies the directory used to store local copies of repository information.

lock_file
    Specifies the lock file path.

noaction
    No action -- test only (default is 0).

nodeps
    Do not follow dependencies (default is 0).

no_install_recommends
    Do NOT install any recommended packages (default is 0).

no_proxy
    Comma-separated list of domain extensions proxy should not be used for.

offline_root
    Specifies directory for offline root installation of packages.

overlay_root
    Specifices the root overlay.

overwrite_no_owner
    Allow overwrite of files not owned by a package (default is 0).

proxy_passwd
    Password to use with proxy authentication.

proxy_user
    User name to use for proxy authentication.

query-all
    Executes a query against all packages from all repositories, not just install packages (default is 0).

signature_ca_file
    Path to the CA certificate file.

signature_ca_path
    Path to certificates directory.

signature_type
    The type of signatures to check against.
    gpg - GPG signature (binary)
    gpg-asc - GPG Signature using ASCII ARMOR
    openssl - OpenSSL Signature Verification

ssl_ca_file (CURL)
    CURL's SSL Certificate Authority file.

ssl_ca_path (CURL)
    CURL's SSL Certificate directory.

ssl_cert (CURL)
    Filename of client certificate.

ssl_cert_type (CURL)
    CURL's SSL Certificate Type.
    PEM - PEM Format (default)
    DER - DER Format

ssl_dont_verify_peer (CURL)
    Dont verify SSL certificates (default is 0).

ssl_engine (CURL)
    Selects the SSL crypto engine to use for cipher operations.
    See curl(1) for more details.

ssl_key (CURL)
    Filename of private SSL key.

ssl_key_passwd (CURL)
    Passphrase to ssl key specified by ssl_key.

ssl_key_type (CURL)
    CURL's SSL Key Type.
    PEM - PEM Format (default)
    DER - DER Format

status_file
    Location of the status file. This file contains all the status of all current/previously installed packages.

tmp_dir
    Temp directory for unpacking a package before loading into the filesystem.

transfer_timeout_ms (CURL)
    Amount of time in ms allowed for a connection to be maintained. Default is 0 (never time out).

verbosity
    Verbosity of output from opkg(1) command. Verbosity levels:
    0 - errors only
    1 - normal messages (default)
    2 - informative messages 3 - debug
    4 - debug level 2

volatile_cache
    Enables volatile cache (default is 0). Volatile cache is located at the directory specified by cache_dir in the subdirectory volatile.