From 3af6d22bb3850ab2bac67287e3a3d3b0e32868e5 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 15 Apr 2024 21:41:07 +0200 Subject: Merging upstream version 6.7. Signed-off-by: Daniel Baumann --- man1/getent.1 | 35 ++++++++++++++----------- man1/iconv.1 | 48 ++++++++++++++++++++++------------ man1/intro.1 | 44 +++++++++++++++---------------- man1/ldd.1 | 32 ++++++++++++++--------- man1/locale.1 | 54 +++++++++++++++++++++++--------------- man1/localedef.1 | 32 ++++++++++++++--------- man1/memusage.1 | 10 ++++---- man1/memusagestat.1 | 4 +-- man1/mtrace.1 | 4 +-- man1/pldd.1 | 18 ++++++++----- man1/sprof.1 | 74 ++++++++++++++++++++++++++++++----------------------- man1/time.1 | 30 +++++++++++----------- 12 files changed, 224 insertions(+), 161 deletions(-) (limited to 'man1') 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 .\" .\" 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 .\" .\" 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 "" 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 -- cgit v1.2.3