diff options
author | Frank Ch. Eigler <fche@redhat.com> | 2019-11-22 14:02:41 -0500 |
---|---|---|
committer | Frank Ch. Eigler <fche@redhat.com> | 2019-11-22 14:02:41 -0500 |
commit | 6594005f4dd8a61d86aec854cbc3cc665bf6012f (patch) | |
tree | 6866a05b8ebb256f12a9ec2df10118d8bbeadecc | |
parent | 3a25c740ee114a3f4bbe9d606ca08f39752b8136 (diff) | |
download | elfutils-debuginfod-submit.tar.gz |
debuginfod client docs: note libcurl passes RFC3986 userinfo authenticationdebuginfod-submit
-rw-r--r-- | doc/debuginfod-find.1 | 5 | ||||
-rw-r--r-- | doc/debuginfod_find_debuginfo.3 | 9 |
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" |