opkg(5) opkg.conf 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

/nix/store/smbpnz7c2jvg30sjqm555camwj372nwj-opkg-0.3.5/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.
February 2018 opkg 0.3.5