summaryrefslogtreecommitdiffstats
path: root/man1
diff options
context:
space:
mode:
Diffstat (limited to 'man1')
-rw-r--r--man1/getent.135
-rw-r--r--man1/iconv.148
-rw-r--r--man1/intro.144
-rw-r--r--man1/ldd.132
-rw-r--r--man1/locale.154
-rw-r--r--man1/localedef.132
-rw-r--r--man1/memusage.110
-rw-r--r--man1/memusagestat.14
-rw-r--r--man1/mtrace.14
-rw-r--r--man1/pldd.118
-rw-r--r--man1/sprof.174
-rw-r--r--man1/time.130
12 files changed, 224 insertions, 161 deletions
diff --git a/man1/getent.1 b/man1/getent.1
index 1168fc5..d1cd5a9 100644
--- a/man1/getent.1
+++ b/man1/getent.1
@@ -3,7 +3,7 @@
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
-.TH getent 1 2023-01-07 "Linux man-pages 6.05.01"
+.TH getent 1 2023-11-01 "Linux man-pages 6.7"
.SH NAME
getent \- get entries from Name Service Switch libraries
.SH SYNOPSIS
@@ -25,12 +25,11 @@ Otherwise, if no
.I key
is provided, all entries will be displayed (unless the database does not
support enumeration).
-.PP
+.P
The
.I database
may be any of those supported by the GNU C Library, listed below:
-.RS 3
-.TP 10
+.TP
.B ahosts
When no
.I key
@@ -41,7 +40,7 @@ and
.BR endhostent (3)
to enumerate the hosts database.
This is identical to using
-.BR hosts .
+.BR hosts (5).
When one or more
.I key
arguments are provided, pass each
@@ -324,41 +323,48 @@ arguments are provided, pass each
in succession to
.BR getspnam (3)
and display the result.
-.RE
.SH OPTIONS
.TP
-.BR \-s\ \fIservice\fP ", " \-\-service\ \fIservice\fP
+.BI \-\-service\~ service
+.TQ
+.BI \-s\~ service
.\" commit 9d0881aa76b399e6a025c5cf44bebe2ae0efa8af (glibc)
Override all databases with the specified service.
(Since glibc 2.2.5.)
.TP
-.BR \-s\ \fIdatabase\fP:\fIservice\fP ", "\
-\-\-service\ \fIdatabase\fP:\fIservice\fP
+.BI \-\-service\~ database : service
+.TQ
+.BI \-s\~ database : service
.\" commit b4f6f4be85d32b9c03361c38376e36f08100e3e8 (glibc)
Override only specified databases with the specified service.
The option may be used multiple times,
but only the last service for each database will be used.
(Since glibc 2.4.)
.TP
-.BR \-i ", " \-\-no\-idn
+.B \-\-no\-idn
+.TQ
+.B \-i
.\" commit a160f8d808cf8020b13bd0ef4a9eaf3c11f964ad (glibc)
Disables IDN encoding in lookups for
.BR ahosts / getaddrinfo (3)
(Since glibc-2.13.)
.TP
-.BR \-? ", " \-\-help
+.B \-\-help
+.TQ
+.B \-?
Print a usage summary and exit.
.TP
-.B "\-\-usage"
+.B \-\-usage
Print a short usage summary and exit.
.TP
-.BR \-V ", " \-\-version
+.B \-\-version
+.TQ
+.B \-V
Print the version number, license, and disclaimer of warranty for
.BR getent .
.SH EXIT STATUS
One of the following exit values can be returned by
.BR getent :
-.RS 3
.TP
.B 0
Command completed successfully.
@@ -377,6 +383,5 @@ could not be found in the
.B 3
Enumeration not supported on this
.IR database .
-.RE
.SH SEE ALSO
.BR nsswitch.conf (5)
diff --git a/man1/iconv.1 b/man1/iconv.1
index 39fb6ba..d1e10f8 100644
--- a/man1/iconv.1
+++ b/man1/iconv.1
@@ -2,7 +2,7 @@
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
-.TH iconv 1 2023-03-30 "Linux man-pages 6.05.01"
+.TH iconv 1 2024-01-28 "Linux man-pages 6.7"
.SH NAME
iconv \- convert text from one character encoding to another
.SH SYNOPSIS
@@ -22,7 +22,7 @@ reads from standard input.
If no output file is given,
.B iconv
writes to standard output.
-.PP
+.P
If no
.I from-encoding
is given, the default is derived
@@ -34,12 +34,16 @@ from the current locale's character
encoding.
.SH OPTIONS
.TP
-.BI \-f " from-encoding" "\fR, \fP\-\-from\-code=" from-encoding
+.BI \-\-from\-code= from-encoding
+.TQ
+.BI \-f\~ from-encoding
Use
.I from-encoding
for input characters.
.TP
-.BI \-t " to-encoding" "\fR, \fP\-\-to\-code=" to-encoding
+.BI \-\-to\-code= to-encoding
+.TQ
+.BI \-t\~ to-encoding
Use
.I to-encoding
for output characters.
@@ -62,32 +66,42 @@ looking characters.
Characters that are outside of the target character set and cannot be
transliterated are replaced with a question mark (?) in the output.
.TP
-.BR \-l ", " \-\-list
+.B \-\-list
+.TQ
+.B \-l
List all known character set encodings.
.TP
-.B "\-c"
+.B \-c
Silently discard characters that cannot be converted instead of
terminating when encountering such characters.
.TP
-.BI \-o " outputfile" "\fR, \fP\-\-output=" outputfile
+.BI \-\-output= outputfile
+.TQ
+.BI \-o\~ outputfile
Use
.I outputfile
for output.
.TP
-.BR \-s ", " \-\-silent
+.B \-\-silent
+.TQ
+.B \-s
This option is ignored; it is provided only for compatibility.
.TP
-.B "\-\-verbose"
+.B \-\-verbose
Print progress information on standard error when processing
multiple files.
.TP
-.BR \-? ", " \-\-help
+.B \-\-help
+.TQ
+.B \-?
Print a usage summary and exit.
.TP
-.B "\-\-usage"
+.B \-\-usage
Print a short usage summary and exit.
.TP
-.BR \-V ", " \-\-version
+.B \-\-version
+.TQ
+.B \-V
Print the version number, license, and disclaimer of warranty for
.BR iconv .
.SH EXIT STATUS
@@ -155,7 +169,7 @@ Usual system default gconv module configuration file.
.TP
.I /usr/lib/gconv/gconv\-modules.cache
Usual system gconv module configuration cache.
-.PP
+.P
Depending on the architecture,
the above files may instead be located at directories with the path prefix
.IR /usr/lib64 .
@@ -164,17 +178,17 @@ POSIX.1-2008.
.SH HISTORY
POSIX.1-2001.
.SH EXAMPLES
-Convert text from the ISO 8859-15 character encoding to UTF-8:
-.PP
+Convert text from the ISO/IEC\~8859-15 character encoding to UTF-8:
+.P
.in +4n
.EX
$ \fBiconv \-f ISO\-8859\-15 \-t UTF\-8 < input.txt > output.txt\fP
.EE
.in
-.PP
+.P
The next example converts from UTF-8 to ASCII, transliterating when
possible:
-.PP
+.P
.in +4n
.EX
$ \fBecho abc ß α € àḃç | iconv \-f UTF\-8 \-t ASCII//TRANSLIT\fP
diff --git a/man1/intro.1 b/man1/intro.1
index 06905e1..bf8a1fe 100644
--- a/man1/intro.1
+++ b/man1/intro.1
@@ -2,7 +2,7 @@
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
-.TH intro 1 2023-05-03 "Linux man-pages 6.05.01"
+.TH intro 1 2023-10-31 "Linux man-pages 6.7"
.SH NAME
intro \- introduction to user commands
.SH DESCRIPTION
@@ -13,7 +13,7 @@ web browsers, file and image viewers and editors, and so on.
Linux is a flavor of UNIX, and as a first approximation
all user commands under UNIX work precisely the same under
Linux (and FreeBSD and lots of other UNIX-like systems).
-.PP
+.P
Under Linux, there are GUIs (graphical user interfaces), where you
can point and click and drag, and hopefully get work done without
first reading lots of documentation.
@@ -52,9 +52,9 @@ See also
.BR dash (1),
.BR ksh (1),
.BR zsh (1).
-.PP
+.P
A session might go like:
-.PP
+.P
.in +4n
.EX
.RB "knuth login: " aeb
@@ -98,9 +98,9 @@ maja 0501\-1136285
$
.EE
.in
-.PP
+.P
Here typing Control-D ended the session.
-.PP
+.P
The
.B $
here was the command prompt\[em]it is the shell's way of indicating
@@ -110,13 +110,13 @@ in lots of ways, and one might include stuff like username,
machine name, current directory, time, and so on.
An assignment PS1="What next, master? "
would change the prompt as indicated.
-.PP
+.P
We see that there are commands
.I date
(that gives date and time), and
.I cal
(that gives a calendar).
-.PP
+.P
The command
.I ls
lists the contents of the current directory\[em]it tells you what
@@ -132,7 +132,7 @@ Owner and permissions can be changed by the commands
.I chown
and
.IR chmod .
-.PP
+.P
The command
.I cat
will show the contents of a file.
@@ -142,26 +142,26 @@ parameters are concatenated and sent to "standard output"
.BR stdout (3)),
here
the terminal screen.)
-.PP
+.P
The command
.I cp
(from "copy") will copy a file.
-.PP
+.P
The command
.I mv
(from "move"), on the other hand, only renames it.
-.PP
+.P
The command
.I diff
lists the differences between two files.
Here there was no output because there were no differences.
-.PP
+.P
The command
.I rm
(from "remove") deletes the file, and be careful! it is gone.
No wastepaper basket or anything.
Deleted means lost.
-.PP
+.P
The command
.I grep
(from "g/re/p") finds occurrences of a string in one or more files.
@@ -185,15 +185,15 @@ to
.I tel
when the current directory is
.IR /home/aeb .
-.PP
+.P
The command
.I pwd
prints the current directory.
-.PP
+.P
The command
.I cd
changes the current directory.
-.PP
+.P
Try alternatively
.I cd
and
@@ -205,11 +205,11 @@ usage: "cd", "cd .", "cd ..", "cd /", and "cd \[ti]".
The command
.I mkdir
makes a new directory.
-.PP
+.P
The command
.I rmdir
removes a directory if it is empty, and complains otherwise.
-.PP
+.P
The command
.I find
(with a rather baroque syntax) will find files with given name
@@ -266,7 +266,7 @@ sends the text through some
usually
.IR less .
Hit the space bar to get the next page, hit q to quit.
-.PP
+.P
In documentation it is customary to refer to man pages
by giving the name and section number, as in
.BR man (1).
@@ -274,12 +274,12 @@ Man pages are terse, and allow you to find quickly some forgotten
detail.
For newcomers an introductory text with more examples
and explanations is useful.
-.PP
+.P
A lot of GNU/FSF software is provided with info files.
Type "info info"
for an introduction on the use of the program
.IR info .
-.PP
+.P
Special topics are often treated in HOWTOs.
Look in
.I /usr/share/doc/howto/en
diff --git a/man1/ldd.1 b/man1/ldd.1
index 1c894de..7375d99 100644
--- a/man1/ldd.1
+++ b/man1/ldd.1
@@ -8,7 +8,7 @@
.\"
.\" SPDX-License-Identifier: GPL-1.0-or-later
.\"
-.TH ldd 1 2023-02-05 "Linux man-pages 6.05.01"
+.TH ldd 1 2023-10-31 "Linux man-pages 6.7"
.SH NAME
ldd \- print shared object dependencies
.SH SYNOPSIS
@@ -21,7 +21,7 @@ prints the shared objects (shared libraries) required by each program or
shared object specified on the command line.
An example of its use and output
is the following:
-.PP
+.P
.in +4n
.EX
$ \fBldd /bin/ls\fP
@@ -36,7 +36,7 @@ $ \fBldd /bin/ls\fP
libpthread.so.0 => /lib64/libpthread.so.0 (0x00007f87e45fa000)
.EE
.in
-.PP
+.P
In the usual case,
.B ldd
invokes the standard dynamic linker (see
@@ -89,7 +89,7 @@ the upstream
.B ldd
implementation did this for example,
although most distributions provided a modified version that did not.)
-.PP
+.P
Thus, you should
.I never
employ
@@ -97,13 +97,13 @@ employ
on an untrusted executable,
since this may result in the execution of arbitrary code.
A safer alternative when dealing with untrusted executables is:
-.PP
+.P
.in +4n
.EX
$ \fBobjdump \-p /path/to/program | grep NEEDED\fP
.EE
.in
-.PP
+.P
Note, however, that this alternative shows only the direct dependencies
of the executable, while
.B ldd
@@ -114,18 +114,26 @@ shows the entire dependency tree of the executable.
Print the version number of
.BR ldd .
.TP
-.BR \-v ", " \-\-verbose
+.B \-\-verbose
+.TQ
+.B \-v
Print all information, including, for example,
symbol versioning information.
.TP
-.BR \-u ", " \-\-unused
+.B \-\-unused
+.TQ
+.B \-u
Print unused direct dependencies.
(Since glibc 2.3.4.)
.TP
-.BR \-d ", " \-\-data\-relocs
+.B \-\-data\-relocs
+.TQ
+.B \-d
Perform relocations and report any missing objects (ELF only).
.TP
-.BR \-r ", " \-\-function\-relocs
+.B \-\-function\-relocs
+.TQ
+.B \-r
Perform relocations for both data objects and functions, and
report any missing objects or functions (ELF only).
.TP
@@ -142,7 +150,7 @@ Usage information.
.\" .B \-V
.\" and only has the equivalent
.\" .BR \-\-version .
-.\" .LP
+.\" .P
.\" The libc5 version of this program will use the name of a library given
.\" on the command line as-is when it contains a \[aq]/\[aq]; otherwise it
.\" searches for the library in the standard locations.
@@ -151,7 +159,7 @@ Usage information.
.SH BUGS
.B ldd
does not work on a.out shared libraries.
-.PP
+.P
.B ldd
does not work with some extremely old a.out programs which were
built before
diff --git a/man1/locale.1 b/man1/locale.1
index 31ca0ea..2e71e68 100644
--- a/man1/locale.1
+++ b/man1/locale.1
@@ -2,7 +2,7 @@
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
-.TH locale 1 2023-05-03 "Linux man-pages 6.05.01"
+.TH locale 1 2023-10-31 "Linux man-pages 6.7"
.SH NAME
locale \- get locale-specific information
.SH SYNOPSIS
@@ -17,7 +17,7 @@ The
.B locale
command displays information about the current locale, or all locales,
on standard output.
-.PP
+.P
When invoked without arguments,
.B locale
displays the current locale settings for each locale category (see
@@ -27,7 +27,7 @@ based on the settings of the environment variables that control the locale
.BR locale (7)).
Values for variables set in the environment are printed without double
quotes, implied values are printed with double quotes.
-.PP
+.P
If either the
.B \-a
or the
@@ -35,7 +35,9 @@ or the
option (or one of their long-format equivalents) is specified,
the behavior is as follows:
.TP
-.BR \-a ", " \-\-all\-locales
+.B \-\-all\-locales
+.TQ
+.B \-a
Display a list of all available locales.
The
.B \-v
@@ -43,11 +45,13 @@ option causes the
.B LC_IDENTIFICATION
metadata about each locale to be included in the output.
.TP
-.BR \-m ", " \-\-charmaps
+.B \-\-charmaps
+.TQ
+.B \-m
Display the available charmaps (character set description files).
To display the current character set for the locale, use
\fBlocale \-c charmap\fR.
-.PP
+.P
The
.B locale
command can also be provided with one or more arguments,
@@ -67,10 +71,12 @@ For a locale keyword, the value of that keyword to be displayed.
.IP \[bu]
For a locale category,
the values of all keywords in that category are displayed.
-.PP
+.P
When arguments are supplied, the following options are meaningful:
.TP
-.BR \-c ", " \-\-category\-name
+.B \-\-category\-name
+.TQ
+.B \-c
For a category name argument,
write the name of the locale category
on a separate line preceding the list of keyword values for that category.
@@ -84,7 +90,9 @@ It can be combined with the
.B \-k
option.
.TP
-.BR \-k ", " \-\-keyword\-name
+.B \-\-keyword\-name
+.TQ
+.B \-k
For each keyword whose value is being displayed,
include also the name of that keyword,
so that the output has the format:
@@ -94,22 +102,28 @@ so that the output has the format:
.IR keyword =\[dq] value \[dq]
.EE
.in
-.PP
+.P
The
.B locale
command also knows about the following options:
.TP
-.BR \-v ", " \-\-verbose
+.B \-\-verbose
+.TQ
+.B \-v
Display additional information for some command-line option and argument
combinations.
.TP
-.BR \-? ", " \-\-help
+.B \-\-help
+.TQ
+.B \-?
Display a summary of command-line options and arguments and exit.
.TP
.B \-\-usage
Display a short usage message and exit.
.TP
-.BR \-V ", " \-\-version
+.B \-\-version
+.TQ
+.B \-V
Display the program version and exit.
.SH FILES
.TP
@@ -139,24 +153,24 @@ LC_TELEPHONE="en_US.UTF\-8"
LC_MEASUREMENT="en_US.UTF\-8"
LC_IDENTIFICATION="en_US.UTF\-8"
LC_ALL=
-.PP
+.P
$ \fBlocale date_fmt\fP
%a %b %e %H:%M:%S %Z %Y
-.PP
+.P
$ \fBlocale \-k date_fmt\fP
date_fmt="%a %b %e %H:%M:%S %Z %Y"
-.PP
+.P
$ \fBlocale \-ck date_fmt\fP
LC_TIME
date_fmt="%a %b %e %H:%M:%S %Z %Y"
-.PP
+.P
$ \fBlocale LC_TELEPHONE\fP
+%c (%a) %l
(%a) %l
11
1
UTF\-8
-.PP
+.P
$ \fBlocale \-k LC_TELEPHONE\fP
tel_int_fmt="+%c (%a) %l"
tel_dom_fmt="(%a) %l"
@@ -164,7 +178,7 @@ int_select="11"
int_prefix="1"
telephone\-codeset="UTF\-8"
.EE
-.PP
+.P
The following example compiles a custom locale from the
.I ./wrk
directory with the
@@ -179,7 +193,7 @@ and
.B LANG
in the shell profile file so that the custom locale will be used in the
subsequent user sessions:
-.PP
+.P
.EX
$ \fBmkdir \-p $HOME/.locale\fP
$ \fBI18NPATH=./wrk/ localedef \-f UTF\-8 \-i fi_SE $HOME/.locale/fi_SE.UTF\-8\fP
diff --git a/man1/localedef.1 b/man1/localedef.1
index 13dd2f0..8326b92 100644
--- a/man1/localedef.1
+++ b/man1/localedef.1
@@ -12,7 +12,7 @@
.\" Lars Wirzenius to document new functionality (as of GNU
.\" C library 2.3.5).
.\"
-.TH localedef 1 2023-03-12 "Linux man-pages 6.05.01"
+.TH localedef 1 2023-10-31 "Linux man-pages 6.7"
.SH NAME
localedef \- compile locale definition files
.SH SYNOPSIS
@@ -58,7 +58,7 @@ locale functions in the C library
etc.),
and places the output in
.IR outputpath .
-.PP
+.P
The
.I outputpath
argument is interpreted as follows:
@@ -92,12 +92,12 @@ system-provided locales;
it is used by all localized programs when the environment variable
.B LOCPATH
is not set.
-.PP
+.P
In any case,
.B localedef
aborts if the directory in which it tries to write locale files has
not already been created.
-.PP
+.P
If no
.I charmapfile
is given,
@@ -206,11 +206,15 @@ Use
to look up aliases for locale names.
There is no default aliases file.
.TP
-.BR \-c ", " \-\-force
+.B \-\-force
+.TQ
+.B \-c
Write the output files even if warnings were generated about the input
file.
.TP
-.BR \-v ", " \-\-verbose
+.B \-\-verbose
+.TQ
+.B \-v
Generate extra warnings about errors that are normally ignored.
.TP
.B \-\-big\-endian
@@ -274,15 +278,19 @@ Supported warnings are
and
.IR intcurrsym .
.TP
-.BR \-? ", " \-\-help
+.B \-\-help
+.TQ
+.B \-?
Print a usage summary and exit.
Also prints the default paths used by
.BR localedef .
.TP
-.B "\-\-usage"
+.B \-\-usage
Print a short usage summary and exit.
.TP
-.BR \-V ", " \-\-version
+.B \-\-version
+.TQ
+.B \-V
Print the version number,
license,
and disclaimer of warranty for
@@ -378,13 +386,13 @@ POSIX.1-2008.
Compile the locale files for Finnish in the UTF\-8 character set
and add it to the default locale archive with the name
.BR fi_FI.UTF\-8 :
-.PP
+.P
.in +4n
.EX
localedef \-f UTF\-8 \-i fi_FI fi_FI.UTF\-8
.EE
.in
-.PP
+.P
The next example does the same thing,
but generates files into the
.I fi_FI.UTF\-8
@@ -393,7 +401,7 @@ variable
.B LOCPATH
is set to the current directory (note that the last argument must
contain a slash):
-.PP
+.P
.in +4n
.EX
localedef \-f UTF\-8 \-i fi_FI ./fi_FI.UTF\-8
diff --git a/man1/memusage.1 b/man1/memusage.1
index 03a5094..fa64544 100644
--- a/man1/memusage.1
+++ b/man1/memusage.1
@@ -2,7 +2,7 @@
.\" and Copyright (C) 2014, Michael Kerrisk <mtk.manpages@gmail.com>
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
-.TH memusage 1 2023-05-03 "Linux man-pages 6.05.01"
+.TH memusage 1 2023-10-31 "Linux man-pages 6.7"
.SH NAME
memusage \- profile memory usage of a program
.SH SYNOPSIS
@@ -33,7 +33,7 @@ optionally, calls to
and
.BR munmap (2)
can also be intercepted.
-.PP
+.P
.B memusage
can output the collected data in textual form, or it can use
.BR memusagestat (1)
@@ -86,7 +86,7 @@ After each function call, the actual stack pointer address is read and
the difference from the base stack pointer computed.
The maximum of these differences is then the stack peak.
.RE
-.PP
+.P
Immediately following this summary line, a table shows the number calls,
total memory allocated or deallocated,
and number of failed calls for each intercepted function.
@@ -102,7 +102,7 @@ For
.BR realloc (3),
the additional field "free" shows reallocations that
caused a block to be freed (i.e., the reallocated size was 0).
-.PP
+.P
The "realloc/total memory" of the table output by
.B memusage
does not reflect cases where
@@ -193,7 +193,7 @@ reallocating the memory in smaller blocks that return to zero.
After compiling the program and running the following commands,
a graph of the memory usage of the program can be found in the file
.IR memusage.png :
-.PP
+.P
.in +4n
.EX
$ \fBmemusage \-\-data=memusage.dat ./a.out\fP
diff --git a/man1/memusagestat.1 b/man1/memusagestat.1
index afce052..d1a76fb 100644
--- a/man1/memusagestat.1
+++ b/man1/memusagestat.1
@@ -1,7 +1,7 @@
.\" Copyright (c) 2013, Peter Schiffer <pschiffe@redhat.com>
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
-.TH memusagestat 1 2022-10-30 "Linux man-pages 6.05.01"
+.TH memusagestat 1 2023-10-31 "Linux man-pages 6.7"
.SH NAME
memusagestat \- generate graphic from memory profiling data
.SH SYNOPSIS
@@ -19,7 +19,7 @@ that file is generated via the
.IR \-\-data )
option of
.BR memusage (1).
-.PP
+.P
The red line in the graph shows the heap usage (allocated memory)
and the green line shows the stack usage.
The x-scale is either the number of memory-handling function calls or
diff --git a/man1/mtrace.1 b/man1/mtrace.1
index 56498d7..3ade2ff 100644
--- a/man1/mtrace.1
+++ b/man1/mtrace.1
@@ -1,7 +1,7 @@
.\" Copyright (c) 2013, Peter Schiffer (pschiffe@redhat.com)
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
-.TH mtrace 1 2022-10-30 "Linux man-pages 6.05.01"
+.TH mtrace 1 2023-10-31 "Linux man-pages 6.7"
.SH NAME
mtrace \- interpret the malloc trace log
.SH SYNOPSIS
@@ -24,7 +24,7 @@ for problem locations
(assuming that
.I binary
was compiled with debugging information).
-.PP
+.P
For more information about the
.BR mtrace (3)
function and
diff --git a/man1/pldd.1 b/man1/pldd.1
index f6859bc..db74dc9 100644
--- a/man1/pldd.1
+++ b/man1/pldd.1
@@ -2,7 +2,7 @@
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
-.TH pldd 1 2023-03-30 "Linux man-pages 6.05.01"
+.TH pldd 1 2023-10-31 "Linux man-pages 6.7"
.SH NAME
pldd \- display dynamic shared objects linked into a process
.SH SYNOPSIS
@@ -19,13 +19,17 @@ The list includes the libraries that have been dynamically loaded using
.BR dlopen (3).
.SH OPTIONS
.TP
-.BR \-? ", " \-\-help
+.B \-\-help
+.TQ
+.B \-?
Display a help message and exit.
.TP
.B \-\-usage
Display a short usage message and exit.
.TP
-.BR \-V ", " \-\-version
+.B \-\-version
+.TQ
+.B \-V
Display program version information and exit.
.SH EXIT STATUS
On success,
@@ -48,16 +52,16 @@ None.
glibc 2.15.
.SH NOTES
The command
-.PP
+.P
.in +4n
.EX
lsof \-p PID
.EE
.in
-.PP
+.P
also shows output that includes the dynamic shared objects
that are linked into a process.
-.PP
+.P
The
.BR gdb (1)
.I "info shared"
@@ -67,7 +71,7 @@ so that one can obtain similar output to
using a command such as the following
(to monitor the process with the specified
.IR pid ):
-.PP
+.P
.in +4n
.EX
$ \fBgdb \-ex "set confirm off" \-ex "set height 0" \-ex "info shared" \e\fP
diff --git a/man1/sprof.1 b/man1/sprof.1
index 186dad4..6d9796b 100644
--- a/man1/sprof.1
+++ b/man1/sprof.1
@@ -2,7 +2,7 @@
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
-.TH sprof 1 2023-05-03 "Linux man-pages 6.05.01"
+.TH sprof 1 2023-10-31 "Linux man-pages 6.7"
.SH NAME
sprof \- read and display shared object profiling data
.SH SYNOPSIS
@@ -27,30 +27,40 @@ in the current directory.
The following command-line options specify the profile output
to be produced:
.TP
-.BR \-c ", " \-\-call\-pairs
+.B \-\-call\-pairs
+.TQ
+.B \-c
Print a list of pairs of call paths for the interfaces exported
by the shared object,
along with the number of times each path is used.
.TP
-.BR \-p ", " \-\-flat\-profile
+.B \-\-flat\-profile
+.TQ
+.B \-p
Generate a flat profile of all of the functions in the monitored object,
with counts and ticks.
.TP
-.BR \-q ", " \-\-graph
+.B \-\-graph
+.TQ
+.B \-q
Generate a call graph.
-.PP
+.P
If none of the above options is specified,
then the default behavior is to display a flat profile and a call graph.
-.PP
+.P
The following additional command-line options are available:
.TP
-.BR \-? ", " \-\-help
+.B \-\-help
+.TQ
+.B \-?
Display a summary of command-line options and arguments and exit.
.TP
.B \-\-usage
Display a short usage message and exit.
.TP
-.BR \-V ", " \-\-version
+.B \-\-version
+.TQ
+.B \-V
Display the program version and exit.
.SH STANDARDS
GNU.
@@ -60,7 +70,7 @@ The following example demonstrates the use of
The example consists of a main program that calls two functions
in a shared object.
First, the code of the main program:
-.PP
+.P
.in +4n
.EX
$ \fBcat prog.c\fP
@@ -78,14 +88,14 @@ main(int argc, char *argv[])
}
.EE
.in
-.PP
+.P
The functions
.IR x1 ()
and
.IR x2 ()
are defined in the following source file that is used to
construct the shared object:
-.PP
+.P
.in +4n
.EX
$ \fBcat libdemo.c\fP
@@ -119,32 +129,32 @@ x2(void)
}
.EE
.in
-.PP
+.P
Now we construct the shared object with the real name
.IR libdemo.so.1.0.1 ,
and the soname
.IR libdemo.so.1 :
-.PP
+.P
.in +4n
.EX
$ \fBcc \-g \-fPIC \-shared \-Wl,\-soname,libdemo.so.1 \e\fP
\fB\-o libdemo.so.1.0.1 libdemo.c\fP
.EE
.in
-.PP
+.P
Then we construct symbolic links for the library soname and
the library linker name:
-.PP
+.P
.in +4n
.EX
$ \fBln \-sf libdemo.so.1.0.1 libdemo.so.1\fP
$ \fBln \-sf libdemo.so.1 libdemo.so\fP
.EE
.in
-.PP
+.P
Next, we compile the main program, linking it against the shared object,
and then list the dynamic dependencies of the program:
-.PP
+.P
.in +4n
.EX
$ \fBcc \-g \-o prog prog.c \-L. \-ldemo\fP
@@ -155,46 +165,46 @@ $ \fBldd prog\fP
/lib64/ld\-linux\-x86\-64.so.2 (0x00007fd4dc51f000)
.EE
.in
-.PP
+.P
In order to get profiling information for the shared object,
we define the environment variable
.B LD_PROFILE
with the soname of the library:
-.PP
+.P
.in +4n
.EX
$ \fBexport LD_PROFILE=libdemo.so.1\fP
.EE
.in
-.PP
+.P
We then define the environment variable
.B LD_PROFILE_OUTPUT
with the pathname of the directory where profile output should be written,
and create that directory if it does not exist already:
-.PP
+.P
.in +4n
.EX
$ \fBexport LD_PROFILE_OUTPUT=$(pwd)/prof_data\fP
$ \fBmkdir \-p $LD_PROFILE_OUTPUT\fP
.EE
.in
-.PP
+.P
.B LD_PROFILE
causes profiling output to be
.I appended
to the output file if it already exists,
so we ensure that there is no preexisting profiling data:
-.PP
+.P
.in +4n
.EX
$ \fBrm \-f $LD_PROFILE_OUTPUT/$LD_PROFILE.profile\fP
.EE
.in
-.PP
+.P
We then run the program to produce the profiling output,
which is written to a file in the directory specified in
.BR LD_PROFILE_OUTPUT :
-.PP
+.P
.in +4n
.EX
$ \fBLD_LIBRARY_PATH=. ./prog\fP
@@ -202,11 +212,11 @@ $ \fBls prof_data\fP
libdemo.so.1.profile
.EE
.in
-.PP
+.P
We then use the
.B sprof \-p
option to generate a flat profile with counts and ticks:
-.PP
+.P
.in +4n
.EX
$ \fBsprof \-p libdemo.so.1 $LD_PROFILE_OUTPUT/libdemo.so.1.profile\fP
@@ -221,11 +231,11 @@ Each sample counts as 0.01 seconds.
0.00 0.10 0.00 1 0.00 x2
.EE
.in
-.PP
+.P
The
.B sprof \-q
option generates a call graph:
-.PP
+.P
.in +4n
.EX
$ \fBsprof \-q libdemo.so.1 $LD_PROFILE_OUTPUT/libdemo.so.1.profile\fP
@@ -248,15 +258,15 @@ index % time self children called name
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
.EE
.in
-.PP
+.P
Above and below, the "<UNKNOWN>" strings represent identifiers that
are outside of the profiled object (in this example, these are instances of
.IR main() ).
-.PP
+.P
The
.B sprof \-c
option generates a list of call pairs and the number of their occurrences:
-.PP
+.P
.in +4n
.EX
$ \fBsprof \-c libdemo.so.1 $LD_PROFILE_OUTPUT/libdemo.so.1.profile\fP
diff --git a/man1/time.1 b/man1/time.1
index df09106..6e4ea37 100644
--- a/man1/time.1
+++ b/man1/time.1
@@ -4,7 +4,7 @@
.\"
.\" SPDX-License-Identifier: GPL-1.0-or-later
.\"
-.TH time 1 2023-07-30 "Linux man-pages 6.05.01"
+.TH time 1 2023-10-31 "Linux man-pages 6.7"
.SH NAME
time \- time a simple command or give resource usage
.SH SYNOPSIS
@@ -40,7 +40,7 @@ values in a
.I "struct tms"
as returned by
.BR times (2)).
-.PP
+.P
Note: some shells (e.g.,
.BR bash (1))
have a built-in
@@ -98,20 +98,20 @@ using the
option or the
.B TIME
environment variable.
-.PP
+.P
The default format string is:
-.PP
+.P
.in +4n
.EX
%Uuser %Ssystem %Eelapsed %PCPU (%Xtext+%Ddata %Mmax)k
%Iinputs+%Ooutputs (%Fmajor+%Rminor)pagefaults %Wswaps
.EE
.in
-.PP
+.P
When the
.I \-p
option is given, the (portable) output format is used:
-.PP
+.P
.in +4n
.EX
real %e
@@ -133,7 +133,7 @@ The conversions follow.
All of those used by
.BR tcsh (1)
are supported.
-.PP
+.P
.B "Time"
.TP
.B %E
@@ -152,7 +152,7 @@ Total number of CPU-seconds that the process spent in user mode.
.TP
.B %P
Percentage of the CPU that this job got, computed as (%U + %S) / %E.
-.PP
+.P
.B "Memory"
.TP
.B %M
@@ -205,7 +205,7 @@ Number of times the process was context-switched involuntarily
.B %w
Number of waits: times that the program was context-switched voluntarily,
for instance while waiting for an I/O operation to complete.
-.PP
+.P
.B "I/O"
.TP
.B %I
@@ -272,10 +272,10 @@ Not all resources are measured by all versions of UNIX,
so some of the values might be reported as zero.
The present selection was mostly inspired by the data
provided by 4.2 or 4.3BSD.
-.PP
+.P
GNU time version 1.7 is not yet localized.
Thus, it does not implement the POSIX requirements.
-.PP
+.P
The environment variable
.B TIME
was badly chosen.
@@ -287,14 +287,14 @@ to use environment variables with the name of a utility to override
the utility to be used.
Uses like MORE or TIME for options to programs
(instead of program pathnames) tend to lead to difficulties.
-.PP
+.P
It seems unfortunate that
.I \-o
overwrites instead of appends.
(That is, the
.I \-a
option should be the default.)
-.PP
+.P
Mail suggestions and bug reports for GNU
.B time
to
@@ -302,13 +302,13 @@ to
Please include the version of
.BR time ,
which you can get by running
-.PP
+.P
.in +4n
.EX
time \-\-version
.EE
.in
-.PP
+.P
and the operating system
and C compiler you used.
.\" .SH AUTHORS