.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "extrepo_5 3pm"
.TH extrepo_5 3pm "2023-12-04" "perl v5.36.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
/etc/extrepo/config.yaml \- config file for extrepo
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 6
\&    url: https://extrepo\-team.pages.debian.net/extrepo\-data
\&    dist: debian
\&    version: bookworm
\&    enabled_policies:
\&    \- main
\&    tor: auto
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
The file /etc/extrepo/config.yaml allows to configure options for
extrepo. It is a simple \s-1YAML\s0 file that is parsed with \s-1YAML::XS\s0 (i.e.,
libyaml); so any formatting options that are supported by that
implementation will be supported by the extrepo config file.
.SH "OPTIONS"
.IX Header "OPTIONS"
The following options are supported:
.IP "url" 4
.IX Item "url"
The \s-1URL\s0 where extrepo will download metadata from. This should usually
be left to its default of
<https://extrepo\-team.pages.debian.net/extrepo\-data>. However, if the
system is behind a firewall, it may be necessary to use a local mirror
or reverse proxy for the extrepo-data repository. In that case, fill out
the \s-1URL\s0 for that mirror or reverse proxy here.
.IP "dist" 4
.IX Item "dist"
It is foreseen that perhaps some downstream distributions of Debian may
want to add support for their own extrepo configuration. In that case,
they would use a different distribution name for this configuration
item.
.Sp
Currently, however, the only supported value for this configuration
option is \f(CW\*(C`debian\*(C'\fR.
.IP "version" 4
.IX Item "version"
The codename of the distribution that you are using. Supported values
here include all active code names for Debian, although the extrepo
program itself is only supported from Debian buster onwards.
.IP "enabled_policies" 4
.IX Item "enabled_policies"
The package licensing policies that are enabled for this system. By
default, only the \*(L"main\*(R" policy is enabled. This policy requires that
all packages in the distribution adhere to the Debian Free Software
Guidelines, or \s-1DFSG,\s0 and that software in such a repository may only
depend on other repositories that have \*(L"main\*(R" as a policy, as in
Debian's \*(L"main\*(R" repository.
.Sp
Additional valid options for this key are \*(L"contrib\*(R", which requires that
licenses for software in the repository also adhere to the \s-1DFSG\s0 (but
makes no such requirements on any dependencies), and \*(L"non-free\*(R", which
has no restrictions whatsoever.
.Sp
While every effort is made that software repositories are labelled
correctly, the maintainers of the extrepo-data repository make no
guarantee as to its correctness.
.IP "tor" 4
.IX Item "tor"
The default tor mode to be used for installed repositories. If not
specified, defaults to \*(L"off\*(R". Can be overridden with the \f(CW\*(C`\-\-tor\*(C'\fR option
to the extrepo command; see the documentation of that option in
\&\fBextrepo\fR\|(1) for a list of the valid options here.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBextrepo\fR\|(1)
.SH "AUTHOR"
.IX Header "AUTHOR"
Wouter Verhelst