summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFrank Ch. Eigler <fche@redhat.com>2019-11-22 14:02:41 -0500
committerFrank Ch. Eigler <fche@redhat.com>2019-11-22 14:02:41 -0500
commit6594005f4dd8a61d86aec854cbc3cc665bf6012f (patch)
tree6866a05b8ebb256f12a9ec2df10118d8bbeadecc
parent3a25c740ee114a3f4bbe9d606ca08f39752b8136 (diff)
downloadelfutils-debuginfod-submit.tar.gz
debuginfod client docs: note libcurl passes RFC3986 userinfo authenticationdebuginfod-submit
-rw-r--r--doc/debuginfod-find.15
-rw-r--r--doc/debuginfod_find_debuginfo.39
2 files changed, 10 insertions, 4 deletions
diff --git a/doc/debuginfod-find.1 b/doc/debuginfod-find.1
index 3dc24bd6..a759ecba 100644
--- a/doc/debuginfod-find.1
+++ b/doc/debuginfod-find.1
@@ -105,7 +105,10 @@ features. It trusts that the binaries returned by the debuginfod(s)
are accurate. Therefore, the list of servers should include only
trustworthy ones. If accessed across HTTP rather than HTTPS, the
network should be trustworthy. Authentication information through
-the internal \fIlibcurl\fP library is not currently enabled.
+the internal \fIlibcurl\fP library is not currently enabled, except
+for the basic plaintext \%\fIhttp[s]://userid:password@hostname/\fP style.
+(The debuginfod server does not perform authentication, but a front-end
+proxy server could.)
.SH "ENVIRONMENT VARIABLES"
diff --git a/doc/debuginfod_find_debuginfo.3 b/doc/debuginfod_find_debuginfo.3
index 66619157..be8eed09 100644
--- a/doc/debuginfod_find_debuginfo.3
+++ b/doc/debuginfod_find_debuginfo.3
@@ -134,7 +134,7 @@ Cleaning of the cache is controlled by the \fIcache_clean_interval_s\fP
and \fImax_unused_age_s\fP files, which are found in the
\fB$DEBUGINFOD_CACHE_PATH\fP directory. \fIcache_clean_interval_s\fP controls
how frequently the cache is traversed for cleaning and \fImax_unused_age_s\fP
-controls how long a file can go unused (\Ifstat(2) atime\fP) before it's
+controls how long a file can go unused (fstat(2) atime) before it's
removed from the cache during cleaning. These files should contain only an
ASCII decimal integer representing the interval or max unused age in seconds.
The default is one day and one week, respectively. Values of zero mean "immediately".
@@ -148,8 +148,11 @@ and
features. They trust that the binaries returned by the debuginfod(s)
are accurate. Therefore, the list of servers should include only
trustworthy ones. If accessed across HTTP rather than HTTPS, the
-network should be trustworthy. Authentication information through
-the internal \fIlibcurl\fP library is not currently enabled.
+network should be trustworthy. Passing user authentication information
+through the internal \fIlibcurl\fP library is not currently enabled, except
+for the basic plaintext \%\fIhttp[s]://userid:password@hostname/\fP style.
+(The debuginfod server does not perform authentication, but a front-end
+proxy server could.)
.SH "ENVIRONMENT VARIABLES"