Lines Matching +full:ipv4 +full:- +full:simple +full:- +full:service +full:- +full:config

1 '\"! tbl | nroff \-man
17 debuginfod \- debuginfo-related http file-server daemon
24 \fBdebuginfod\fP serves debuginfo-related artifacts over HTTP.  It
30 If a debuginfod cannot service a given buildid artifact request
33 \fBdebuginfod-find\fP would.  If successful, it locally caches then
38 (see the \fB\-L\fP option).  Duplicate PATHs are ignored.  You may use
41 thread enumerates all matching files (see the \fB\-I\fP and \fB\-X\fP
43 \fB\-c\fP option) wait at the work queue to analyze files in parallel.
45 If the \fB\-F\fP option is given, each file is scanned as an ELF/DWARF
55 % eu-readelf -wline BINARY | sed -n '/^Directory.table/,/^File.name.table/p'
57 % eu-readelf -wline BINARY | sed -n '/^Directory.table/,/^Line.number/p'
59 % debuginfod -vvv -d :memory: -F BINARY 2>&1 | grep 'recorded.*source'
63 If any of the \fB\-R\fP, \fB-U\fP, or \fB-Z\fP options is given, each
65 files.  Archive files are recognized by extension.  If \-R is given,
66 ".rpm" files are scanned; if \-U is given, ".deb" and ".ddeb" files
67 are scanned; if \-Z is given, the listed extensions are scanned.
68 Because of complications such as DWZ-compressed debuginfo, may require
70 for RPMs are only served from other RPMs, so the caution for \-F does
79 \fBdebuginfod\fP will only serve content from a read-only index and
85 .B "\-F"
89 .B "\-Z EXT" "\-Z EXT=CMD"
100 .B "\-R"
102 Equivalent to \fB\%\-Z\~.rpm=cat\fP, since libarchive can natively
106 with \fB\%\-Z\ .rpm='(rpm2cpio|zstdcat)<'\fP instead of \fB\-R\fP.
109 .B "\-U"
111 Equivalent to \fB\%\-Z\ .deb='dpkg-deb\ \-\-fsys\-tarfile\fP'
112 \fB\%\-Z\ .ddeb='dpkg-deb\ \-\-fsys\-tarfile'\fP.
115 .B "\-d FILE" "\-\-database=FILE"
122 testing the magic string ":memory:" can be used to use an one-time
123 memory-only database.  The default database file is
127 .B "\-\-passive"
131 read-only.  This way a database can be safely shared between a active
133 service load.  Archive pattern options must still be given, so
137 .B "\-D SQL" "\-\-ddl=SQL"
140 useful to tune performance-related pragmas or indexes.  May be
144 .B "\-p NUM" "\-\-port=NUM"
146 listen, to service HTTP requests.  Both IPv4 and IPV6 sockets are
151 .B "\-I REGEX"  "\-\-include=REGEX"  "\-X REGEX"  "\-\-exclude=REGEX"
163 .B "\-t SECONDS"  "\-\-rescan\-time=SECONDS"
174 .B "\-r"
175 Apply the -I and -X during groom cycles, so that most content related
177 content can be practically removed, so eventually a "\-G"
178 "maximal-groom" operation may be needed.
181 .B "\-g SECONDS" "\-\-groom\-time=SECONDS"
194 .B "\-G"
195 Run an extraordinary maximal-grooming pass at debuginfod startup.
197 debuginfo-unrelated content from the archive-related parts of the index.
198 It should not be run if any recent archive-related indexing operations
202 do maximal-grooming.  See also the \fIDATA MANAGEMENT\fP section.
205 .B "\-c NUM"  "\-\-concurrency=NUM"
208 This important for controlling CPU-intensive operations like parsing
214 .B "\-C" "\-C=NUM" "\-\-connection\-pool" "\-\-connection\-pool=NUM"
220 no option, \-C	use a fixed thread pool sized automatically
221 \-C=NUM	use a fixed thread pool sized NUM, minimum 2
224 The first mode is a simple and safe configuration related to the
226 suitable for tuned load-limiting configurations facing unruly traffic.
229 .B "\-L"
231 including across devices - as in \fIfind\ -L\fP.  The default is to
233 device, and ignore symlinks - as in \fIfind\ -P\ -xdev\fP.  Caution: a
238 .B "\-\-fdcache\-fds=NUM"  "\-\-fdcache\-mbs=MB"
249 .B "\-\-fdcache\-prefetch\-fds=NUM"  "\-\-fdcache\-prefetch\-mbs=MB"
250 .B "\-\-fdcache\-prefetch=NUM2"
263 .B "\-\-fdcache\-mintmp=NUM"
269 are intended to give an operator notice about storage scarcity - which
274 .B "\-\-forwarded\-ttl\-limit=NUM"
275 Configure limits of X-Forwarded-For hops. if X-Forwarded-For
280 .B "\-\-disable\-source\-scan"
286 .B "\-\-scan\-checkpoint=NUM"
289 phase somewhat, but generate much smaller "-wal" temporary files on
293 .B "\-v"
299 .\" Much of the following text is duplicated with debuginfod-find.1
301 debuginfod's webapi resembles ordinary file service, where a GET
304 This file service resemblance is intentional, so that an installation
308 providing additional metadata about the buildid-related response.  For example:
311 % debuginfod-find -v debuginfo /bin/ls |& grep -i x-debuginfo
312 x-debuginfod-size: 502024
313 x-debuginfod-archive: /mnt/fedora_koji_prod/koji/packages/coreutils/9.3/4.fc39/x86_64/coreutils-deb…
314 x-debuginfod-file: /usr/lib/debug/usr/bin/ls-9.3-4.fc39.x86_64.debug
318 X-DEBUGINFOD-SIZE
319 The size of the file, in bytes.  This may differ from the http Content-Length:
323 X-DEBUGINFOD-FILE
327 X-DEBUGINFOD-ARCHIVE
333 There are a handful of buildid-related requests.  In each case, the
338 % readelf -n /bin/ls | grep -A4 build.id
375 compilation-directory, followed by a mandatory "/".
391 Note: the client should %-escape characters in /SOURCE/FILE that are
418 of data to record all debuginfo-related data of potentially a great
431 gzip-compressed cpio files), the sqlite index database tends to be
434 much debuginfo-unrelated content.  It may be even larger during the
435 indexing phase due to temporary sqlite write-ahead-logging files;
437 be helpful to apply tight \-I or \-X regular-expression constraints to
438 exclude files from scanning that you know have no debuginfo-relevant
448 one-shot \fImaximal grooming\fP pass is available.  It removes
449 information debuginfo-unrelated data from the archive content index
454 size as free space.  Worse: it may result in missing source-code info
459 of error messages on -ENOSPC is ugly and nagging.  But, like for most
464 sqlite offers several performance-related options in the form of
465 pragmas.  Some may be useful to fine-tune the defaults plus the
466 debuginfod extras.  The \-D option may be useful to tell debuginfod to
470 via \-D, if you're searching for peak performance.  The "optimize",
472 debuginfod.  The default settings are performance- rather than
473 reliability-oriented, so a hardware crash might corrupt the database.
481 will not be wasted for retaining a no-longer-useable dataset.
483 In summary, if your system can bear a 0.5%-3% index-to-archive-dataset
490 disabled, and the index database remains read-only.  This makes the
492 simple one-way replication, and data management considerations are
500 a denial-of-service in terms of RAM, CPU, disk I/O, or network I/O.
502 HTTPS reverse-proxy front-end that enforces site policies for
506 Front-end proxies may elide sensitive path name components in
507 X-DEBUGINFOD-FILE/ARCHIVE response headers.  For example, using Apache
512 Header edit x-debuginfod-archive ".*/" ""
524 .so man7/debuginfod-client-config.7
534 .I "debuginfod-find(1)"