Skip to content

[docs] Better counting #1450

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Aug 13, 2019
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
[doc] Add user_agent option
This option is a new addition to libdnf.
  • Loading branch information
dmnks committed Aug 13, 2019
commit 24e6fadf03284b7892c9a7e9bc5e154c1138d854
34 changes: 34 additions & 0 deletions doc/conf_ref.rst
Original file line number Diff line number Diff line change
Expand Up @@ -648,6 +648,40 @@ configuration.

The password to use for connecting to repo with basic HTTP authentication. Empty by default.

``user_agent``
:ref:`string <string-label>`

The User-Agent string to include in HTTP requests sent by DNF.
Defaults to ::

libdnf/VERSION (NAME VERSION_ID; VARIANT_ID; OS.BASEARCH)

where VERSION is the libdnf version, NAME, VERSION_ID and VARIANT_ID are OS
identifiers read from the :manpage:`os-release(5)` file and OS and BASEARCH
are the canonical OS name and base architecture, respectively.
Example: ::

libdnf/0.35.2 (Fedora 31; server; Linux.x86_64)

To prevent the leakage of identifiable information, the whole OS part
(enclosed in parenthesis) is omitted if this is a non-Fedora or non-Linux
system, or is running an unknown Fedora variant.

``countme``
:ref:`boolean <boolean-label>`

Determines whether a "countme" flag should be added to a single, randomly
chosen metalink query each week.
This allows the repository owner to estimate the number of systems
consuming it, by counting such queries over a week's time, which is much
more accurate than just counting unique IP addresses (which is subject to
both overcounting and undercounting due to short DHCP leases and NAT,
respectively).
The flag is a simple static parameter appended to the metalink URL and is
the same on every system (that means, no personal or machine-specific
information is included).
Default is False.

=================
Types of Options
=================
Expand Down