oc/bitbake-user-manual/bitbake-user-manual-fetching.rst
@@ -221,13 +221,18 @@ HTTP/FTP wget fetcher (``http://``, ``ftp://``, ``h=
ttps://``)
This fetcher obtains files from web and FTP servers. Internally, the
fetcher uses the wget utility.
=20
-The executable and parameters used are specified by the
-``FETCHCMD_wget`` variable, which defaults to sensible values. The
-fetcher supports a parameter "downloadfilename" that allows the name of
-the downloaded file to be specified. Specifying the name of the
-downloaded file is useful for avoiding collisions in
-:term:`DL_DIR` when dealing with multiple files that
-have the same name.
+The executable and parameters used are specified by the ``FETCHCMD_wget`=
`
+variable, which defaults to sensible values. The fetcher supports
+parameters, "downloadfilename" that allows the name of the downloaded
+file to be specified and "user_agent" parameter which enable to use
+a default ``Mozilla/5.0`` user-agent or a custom string value
+via usage of :term:`BB_USER_AGENT`.
+
+Specifying the name of the downloaded file is useful for avoiding
+collisions in :term:`DL_DIR` when dealing with multiple files
+that have the same name. A few HTTP servers block requests with
+the default wget user-agent, in this case specifying a valid
+user-agent can solve this issue.
=20
If a username and password are specified in the ``SRC_URI``, a Basic
Authorization header will be added to each request, including across red=
irects.
@@ -239,6 +244,7 @@ Some example URLs are as follows::
SRC_URI =3D "http://oe.handhelds.org/not_there.aac"
SRC_URI =3D "ftp://oe.handhelds.org/not_there_as_well.aac"
SRC_URI =3D "ftp://you@oe.handhelds.org/home/you/secret.plan"
+ SRC_URI =3D "https://oe.handhelds.org/not_there.aac;user_agent=3D1"
=20
.. note::
=20
t b/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst
@@ -699,6 +699,10 @@ overview of their function and contents.
Within an executing task, this variable holds the hash of the task=
as
returned by the currently enabled signature generator.
=20
+ :term:`BB_USER_AGENT`
+ Specifies a user-agent string which BitBake uses if "user_agent"
+ parameter is enabled for HTTP/FTP wget fetcher.
+
:term:`BB_VERBOSE_LOGS`
Controls how verbose BitBake is during builds. If set, shell scrip=
ts
echo commands and shell script output appears on standard out
@@ -56,7 +56,7 @@ class Wget(FetchMethod):
# CDNs like CloudFlare may do a 'browser integrity test' which can f=
ail
# with the standard wget/urllib User-Agent, so pretend to be a moder=
n
# browser.
- user_agent =3D "Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:84.0) Gec=
ko/20100101 Firefox/84.0"
+ user_agent =3D "Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:126.0) Ge=