docs: Added All OpenBSD Manuals

1 files changed, 528 insertions, 0 deletions

diff --git a/static/openbsd/man1/llvm-profdata.1 b/static/openbsd/man1/llvm-profdata.1
new file mode 100644
index 00000000..32ff2bb0
--- /dev/null
+++ b/static/openbsd/man1/llvm-profdata.1
@@ -0,0 +1,528 @@
+.\" Man page generated from reStructuredText.
+.
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.TH "LLVM-PROFDATA" "1" "2024-12-23" "19" "LLVM"
+.SH NAME
+llvm-profdata \- Profile data tool
+.SH SYNOPSIS
+.sp
+\fBllvm\-profdata\fP \fIcommand\fP [\fIargs...\fP]
+.SH DESCRIPTION
+.sp
+The \fBllvm\-profdata\fP tool is a small utility for working with profile
+data files.
+.SH COMMANDS
+.INDENT 0.0
+.IP \(bu 2
+\fI\%merge\fP
+.IP \(bu 2
+\fI\%show\fP
+.IP \(bu 2
+\fI\%overlap\fP
+.IP \(bu 2
+\fI\%order\fP
+.UNINDENT
+.SH MERGE
+.SS SYNOPSIS
+.sp
+\fBllvm\-profdata merge\fP [\fIoptions\fP] [\fIfilename...\fP]
+.SS DESCRIPTION
+.sp
+\fBllvm\-profdata merge\fP takes several profile data files
+generated by PGO instrumentation and merges them together into a single
+indexed profile data file.
+.sp
+By default profile data is merged without modification. This means that the
+relative importance of each input file is proportional to the number of samples
+or counts it contains. In general, the input from a longer training run will be
+interpreted as relatively more important than a shorter run. Depending on the
+nature of the training runs it may be useful to adjust the weight given to each
+input file by using the \fB\-weighted\-input\fP option.
+.sp
+Profiles passed in via \fB\-weighted\-input\fP, \fB\-input\-files\fP, or via positional
+arguments are processed once for each time they are seen.
+.SS OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-help
+Print a summary of command line options.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-output=<output>, \-o
+Specify the output file name.  \fIOutput\fP cannot be \fB\-\fP as the resulting
+indexed profile data can\(aqt be written to standard output.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-weighted\-input=<weight,filename>
+Specify an input file name along with a weight. The profile counts of the
+supplied \fBfilename\fP will be scaled (multiplied) by the supplied
+\fBweight\fP, where \fBweight\fP is a decimal integer >= 1.
+Input files specified without using this option are assigned a default
+weight of 1. Examples are shown below.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-input\-files=<path>, \-f
+Specify a file which contains a list of files to merge. The entries in this
+file are newline\-separated. Lines starting with \(aq#\(aq are skipped. Entries may
+be of the form <filename> or <weight>,<filename>.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-remapping\-file=<path>, \-r
+Specify a file which contains a remapping from symbol names in the input
+profile to the symbol names that should be used in the output profile. The
+file should consist of lines of the form \fB<input\-symbol> <output\-symbol>\fP\&.
+Blank lines and lines starting with \fB#\fP are skipped.
+.sp
+The \fI\%llvm\-cxxmap\fP tool can be used to generate the symbol
+remapping file.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-instr (default)
+Specify that the input profile is an instrumentation\-based profile.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-sample
+Specify that the input profile is a sample\-based profile.
+.sp
+The format of the generated file can be generated in one of three ways:
+.INDENT 7.0
+.TP
+.B \-\-binary (default)
+.UNINDENT
+.sp
+Emit the profile using a binary encoding. For instrumentation\-based profile
+the output format is the indexed binary format.
+.INDENT 7.0
+.TP
+.B \-\-extbinary
+.UNINDENT
+.sp
+Emit the profile using an extensible binary encoding. This option can only
+be used with sample\-based profile. The extensible binary encoding can be
+more compact with compression enabled and can be loaded faster than the
+default binary encoding.
+.INDENT 7.0
+.TP
+.B \-\-text
+.UNINDENT
+.sp
+Emit the profile in text mode. This option can also be used with both
+sample\-based and instrumentation\-based profile. When this option is used
+the profile will be dumped in the text format that is parsable by the profile
+reader.
+.INDENT 7.0
+.TP
+.B \-\-gcc
+.UNINDENT
+.sp
+Emit the profile using GCC\(aqs gcov format (Not yet supported).
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-sparse[=true|false]
+Do not emit function records with 0 execution count. Can only be used in
+conjunction with \-instr. Defaults to false, since it can inhibit compiler
+optimization during PGO.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-num\-threads=<N>, \-j
+Use N threads to perform profile merging. When N=0, llvm\-profdata auto\-detects
+an appropriate number of threads to use. This is the default.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-failure\-mode=[any|all]
+Set the failure mode. There are two options: \(aqany\(aq causes the merge command to
+fail if any profiles are invalid, and \(aqall\(aq causes the merge command to fail
+only if all profiles are invalid. If \(aqall\(aq is set, information from any
+invalid profiles is excluded from the final merged product. The default
+failure mode is \(aqany\(aq.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-prof\-sym\-list=<path>
+Specify a file which contains a list of symbols to generate profile symbol
+list in the profile. This option can only be used with sample\-based profile
+in extbinary format. The entries in this file are newline\-separated.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-compress\-all\-sections=[true|false]
+Compress all sections when writing the profile. This option can only be used
+with sample\-based profile in extbinary format.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-use\-md5=[true|false]
+Use MD5 to represent string in name table when writing the profile.
+This option can only be used with sample\-based profile in extbinary format.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-gen\-partial\-profile=[true|false]
+Mark the profile to be a partial profile which only provides partial profile
+coverage for the optimized target. This option can only be used with
+sample\-based profile in extbinary format.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-convert\-sample\-profile\-layout=[nest|flat]
+Convert the merged profile into a profile with a new layout. Supported
+layout are \fBnest\fP (Nested profile, the input should be CS flat profile) and
+\fBflat\fP (Profile with nested inlinees flattened out).
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-supplement\-instr\-with\-sample=<file>
+Supplement an instrumentation profile with sample profile. The sample profile
+is the input of the flag. Output will be in instrumentation format (only works
+with \-instr).
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-zero\-counter\-threshold=<float>
+For the function which is cold in instr profile but hot in sample profile, if
+the ratio of the number of zero counters divided by the total number of
+counters is above the threshold, the profile of the function will be regarded
+as being harmful for performance and will be dropped.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-instr\-prof\-cold\-threshold=<int>
+User specified cold threshold for instr profile which will override the cold
+threshold got from profile summary.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-suppl\-min\-size\-threshold=<int>
+If the size of a function is smaller than the threshold, assume it can be
+inlined by PGO early inliner and it will not be adjusted based on sample
+profile.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-debug\-info=<path>
+Specify the executable or \fB\&.dSYM\fP that contains debug info for the raw profile.
+When \fB\-\-debug\-info\-correlate\fP or \fB\-\-profile\-correlate=debug\-info\fP was used
+for instrumentation, use this option to correlate the raw profile.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-binary\-file=<path>
+Specify the executable that contains profile data and profile name sections for
+the raw profile. When \fB\-profile\-correlate=binary\fP was used for
+instrumentation, use this option to correlate the raw profile.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-temporal\-profile\-trace\-reservoir\-size
+The maximum number of temporal profile traces to be stored in the output
+profile. If more traces are added, we will use reservoir sampling to select
+which traces to keep. Note that changing this value between different merge
+invocations on the same indexed profile could result in sample bias. The
+default value is 100.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-temporal\-profile\-max\-trace\-length
+The maximum number of functions in a single temporal profile trace. Longer
+traces will be truncated. The default value is 1000.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-function=<string>
+Only keep functions matching the regex in the output, all others are erased
+from the profile.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-no\-function=<string>
+Remove functions matching the regex from the profile. If both \-\-function and
+\-\-no\-function are specified and a function matches both, it is removed.
+.UNINDENT
+.SS EXAMPLES
+.SS Basic Usage
+.sp
+Merge three profiles:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+llvm\-profdata merge foo.profdata bar.profdata baz.profdata \-output merged.profdata
+.EE
+.UNINDENT
+.UNINDENT
+.SS Weighted Input
+.sp
+The input file \fBfoo.profdata\fP is especially important, multiply its counts by 10:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+llvm\-profdata merge \-\-weighted\-input=10,foo.profdata bar.profdata baz.profdata \-\-output merged.profdata
+.EE
+.UNINDENT
+.UNINDENT
+.sp
+Exactly equivalent to the previous invocation (explicit form; useful for programmatic invocation):
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+llvm\-profdata merge \-\-weighted\-input=10,foo.profdata \-\-weighted\-input=1,bar.profdata \-\-weighted\-input=1,baz.profdata \-\-output merged.profdata
+.EE
+.UNINDENT
+.UNINDENT
+.SH SHOW
+.SS SYNOPSIS
+.sp
+\fBllvm\-profdata show\fP [\fIoptions\fP] [\fIfilename\fP]
+.SS DESCRIPTION
+.sp
+\fBllvm\-profdata show\fP takes a profile data file and displays the
+information about the profile counters for this file and
+for any of the specified function(s).
+.sp
+If \fIfilename\fP is omitted or is \fB\-\fP, then \fBllvm\-profdata show\fP reads its
+input from standard input.
+.SS OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-all\-functions
+Print details for every function.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-binary\-ids
+Print embedded binary ids in a profile.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-counts
+Print the counter values for the displayed functions.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-show\-format=<text|json|yaml>
+Emit output in the selected format if supported by the provided profile type.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-function=<string>
+Print details for a function if the function\(aqs name contains the given string.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-help
+Print a summary of command line options.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-output=<output>, \-o
+Specify the output file name.  If \fIoutput\fP is \fB\-\fP or it isn\(aqt specified,
+then the output is sent to standard output.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-instr (default)
+Specify that the input profile is an instrumentation\-based profile.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-text
+Instruct the profile dumper to show profile counts in the text format of the
+instrumentation\-based profile data representation. By default, the profile
+information is dumped in a more human readable form (also in text) with
+annotations.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-topn=<n>
+Instruct the profile dumper to show the top \fBn\fP functions with the
+hottest basic blocks in the summary section. By default, the topn functions
+are not dumped.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-sample
+Specify that the input profile is a sample\-based profile.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-memop\-sizes
+Show the profiled sizes of the memory intrinsic calls for shown functions.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-value\-cutoff=<n>
+Show only those functions whose max count values are greater or equal to \fBn\fP\&.
+By default, the value\-cutoff is set to 0.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-list\-below\-cutoff
+Only output names of functions whose max count value are below the cutoff
+value.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-profile\-version
+Print profile version.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-showcs
+Only show context sensitive profile counts. The default is to filter all
+context sensitive profile counts.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-show\-prof\-sym\-list=[true|false]
+Show profile symbol list if it exists in the profile. This option is only
+meaningful for sample\-based profile in extbinary format.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-show\-sec\-info\-only=[true|false]
+Show basic information about each section in the profile. This option is
+only meaningful for sample\-based profile in extbinary format.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-debug\-info=<path>
+Specify the executable or \fB\&.dSYM\fP that contains debug info for the raw profile.
+When \fB\-\-debug\-info\-correlate\fP or \fB\-\-profile\-correlate=debug\-info\fP was used
+for instrumentation, use this option to show the correlated functions from the
+raw profile.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-covered
+Show only the functions that have been executed, i.e., functions with non\-zero
+counts.
+.UNINDENT
+.SH OVERLAP
+.SS SYNOPSIS
+.sp
+\fBllvm\-profdata overlap\fP [\fIoptions\fP] [\fIbase profile file\fP] [\fItest profile file\fP]
+.SS DESCRIPTION
+.sp
+\fBllvm\-profdata overlap\fP takes two profile data files and displays the
+\fIoverlap\fP of counter distribution between the whole files and between any of the
+specified functions.
+.sp
+In this command, \fIoverlap\fP is defined as follows:
+Suppose \fIbase profile file\fP has the following counts:
+{c1_1, c1_2, ..., c1_n, c1_u_1, c2_u_2, ..., c2_u_s},
+and \fItest profile file\fP has
+{c2_1, c2_2, ..., c2_n, c2_v_1, c2_v_2, ..., c2_v_t}.
+Here c{1|2}_i (i = 1 .. n) are matched counters and c1_u_i (i = 1 .. s) and
+c2_v_i (i = 1 .. v) are unmatched counters (or counters only existing in)
+\fIbase profile file\fP and \fItest profile file\fP, respectively.
+Let sum_1 = c1_1 + c1_2 +  ... + c1_n +  c1_u_1 + c2_u_2 + ... + c2_u_s, and
+sum_2 = c2_1 + c2_2 + ... + c2_n + c2_v_1 + c2_v_2 + ... + c2_v_t.
+\fIoverlap\fP = min(c1_1/sum_1, c2_1/sum_2) + min(c1_2/sum_1, c2_2/sum_2) + ...
++ min(c1_n/sum_1, c2_n/sum_2).
+.sp
+The result overlap distribution is a percentage number, ranging from 0.0% to
+100.0%, where 0.0% means there is no overlap and 100.0% means a perfect
+overlap.
+.sp
+Here is an example, if \fIbase profile file\fP has counts of {400, 600}, and
+\fItest profile file\fP has matched counts of {60000, 40000}. The \fIoverlap\fP is 80%.
+.SS OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-function=<string>
+Print details for a function if the function\(aqs name contains the given string.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-help
+Print a summary of command line options.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-output=<output>, \-o
+Specify the output file name.  If \fIoutput\fP is \fB\-\fP or it isn\(aqt specified,
+then the output is sent to standard output.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-value\-cutoff=<n>
+Show only those functions whose max count values are greater or equal to \fBn\fP\&.
+By default, the value\-cutoff is set to max of unsigned long long.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-cs
+Only show overlap for the context sensitive profile counts. The default is to show
+non\-context sensitive profile counts.
+.UNINDENT
+.SH ORDER
+.SS SYNOPSIS
+.sp
+\fBllvm\-profdata order\fP [\fIoptions\fP] [\fIfilename\fP]
+.SS DESCRIPTION
+.sp
+\fBllvm\-profdata order\fP uses temporal profiling traces from a profile and
+finds a function order that reduces the number of page faults for those traces.
+This output can be directly passed to \fBlld\fP via \fB\-\-symbol\-ordering\-file=\fP
+for ELF or \fB\-order\-file\fP for Mach\-O. If the traces found in the profile are
+representative of the real world, then this order should improve startup
+performance.
+.SS OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-help
+Print a summary of command line options.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-output=<output>, \-o
+Specify the output file name.  If \fIoutput\fP is \fB\-\fP or it isn\(aqt specified,
+then the output is sent to standard output.
+.UNINDENT
+.SH EXIT STATUS
+.sp
+\fBllvm\-profdata\fP returns 1 if the command is omitted or is invalid,
+if it cannot read input files, or if there is a mismatch between their data.
+.SH AUTHOR
+Maintained by the LLVM Team (https://llvm.org/).
+.SH COPYRIGHT
+2003-2024, LLVM Project
+.\" Generated by docutils manpage writer.
+.