Date: Mon, 2 Mar 2015 23:03:54 +0000 (UTC) From: Navdeep Parhar <np@FreeBSD.org> To: src-committers@freebsd.org, svn-src-projects@freebsd.org Subject: svn commit: r279555 - in projects/cxl_iscsi: . contrib/binutils/binutils/doc contrib/binutils/gas/doc contrib/binutils/ld contrib/diff/doc contrib/gperf/doc contrib/libucl contrib/libucl/cmake cont... Message-ID: <201503022303.t22N3sQf060940@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: np Date: Mon Mar 2 23:03:53 2015 New Revision: 279555 URL: https://svnweb.freebsd.org/changeset/base/279555 Log: Merge r279515 through r279554 (mainly to get r279554 in this branch). Added: projects/cxl_iscsi/contrib/binutils/binutils/doc/binutils.7 - copied unchanged from r279554, head/contrib/binutils/binutils/doc/binutils.7 projects/cxl_iscsi/contrib/binutils/gas/doc/as.7 - copied unchanged from r279554, head/contrib/binutils/gas/doc/as.7 projects/cxl_iscsi/contrib/binutils/ld/ld.7 - copied unchanged from r279554, head/contrib/binutils/ld/ld.7 projects/cxl_iscsi/contrib/binutils/ld/ldint.7 - copied unchanged from r279554, head/contrib/binutils/ld/ldint.7 projects/cxl_iscsi/contrib/diff/doc/diff.7 - copied unchanged from r279554, head/contrib/diff/doc/diff.7 projects/cxl_iscsi/contrib/gperf/doc/gperf.7 - copied unchanged from r279554, head/contrib/gperf/doc/gperf.7 projects/cxl_iscsi/contrib/libucl/klib/ - copied from r279554, head/contrib/libucl/klib/ projects/cxl_iscsi/contrib/libucl/tests/basic/14.in - copied unchanged from r279554, head/contrib/libucl/tests/basic/14.in projects/cxl_iscsi/contrib/libucl/tests/basic/14.res - copied unchanged from r279554, head/contrib/libucl/tests/basic/14.res projects/cxl_iscsi/contrib/mdocml/Makefile.local - copied unchanged from r279554, head/contrib/mdocml/Makefile.local projects/cxl_iscsi/contrib/mdocml/compat_strtonum.c - copied unchanged from r279554, head/contrib/mdocml/compat_strtonum.c projects/cxl_iscsi/contrib/mdocml/test-strtonum.c - copied unchanged from r279554, head/contrib/mdocml/test-strtonum.c projects/cxl_iscsi/sys/modules/dtb/imx6/ - copied from r279554, head/sys/modules/dtb/imx6/ Deleted: projects/cxl_iscsi/contrib/binutils/gas/doc/as.txt projects/cxl_iscsi/contrib/binutils/ld/ld.txt projects/cxl_iscsi/contrib/libucl/m4/ Modified: projects/cxl_iscsi/ObsoleteFiles.inc projects/cxl_iscsi/contrib/libucl/ChangeLog.md projects/cxl_iscsi/contrib/libucl/Makefile.am projects/cxl_iscsi/contrib/libucl/README.md projects/cxl_iscsi/contrib/libucl/cmake/CMakeLists.txt projects/cxl_iscsi/contrib/libucl/configure.ac projects/cxl_iscsi/contrib/libucl/doc/Makefile.am projects/cxl_iscsi/contrib/libucl/doc/api.md projects/cxl_iscsi/contrib/libucl/doc/libucl.3 projects/cxl_iscsi/contrib/libucl/doc/pandoc.template projects/cxl_iscsi/contrib/libucl/include/ucl.h projects/cxl_iscsi/contrib/libucl/src/Makefile.am projects/cxl_iscsi/contrib/libucl/src/ucl_emitter.c projects/cxl_iscsi/contrib/libucl/src/ucl_emitter_utils.c projects/cxl_iscsi/contrib/libucl/src/ucl_hash.c projects/cxl_iscsi/contrib/libucl/src/ucl_hash.h projects/cxl_iscsi/contrib/libucl/src/ucl_internal.h projects/cxl_iscsi/contrib/libucl/src/ucl_parser.c projects/cxl_iscsi/contrib/libucl/src/ucl_schema.c projects/cxl_iscsi/contrib/libucl/src/ucl_util.c projects/cxl_iscsi/contrib/libucl/tests/schema.test projects/cxl_iscsi/contrib/libucl/tests/test_generate.c projects/cxl_iscsi/contrib/libucl/tests/test_schema.c projects/cxl_iscsi/contrib/libucl/uthash/utstring.h projects/cxl_iscsi/contrib/libucl/utils/objdump.c projects/cxl_iscsi/contrib/mdocml/LICENSE projects/cxl_iscsi/contrib/mdocml/Makefile projects/cxl_iscsi/contrib/mdocml/Makefile.depend projects/cxl_iscsi/contrib/mdocml/TODO projects/cxl_iscsi/contrib/mdocml/apropos.1 projects/cxl_iscsi/contrib/mdocml/cgi.c projects/cxl_iscsi/contrib/mdocml/chars.c projects/cxl_iscsi/contrib/mdocml/chars.in projects/cxl_iscsi/contrib/mdocml/compat_fts.c projects/cxl_iscsi/contrib/mdocml/config.h projects/cxl_iscsi/contrib/mdocml/configure projects/cxl_iscsi/contrib/mdocml/configure.local.example projects/cxl_iscsi/contrib/mdocml/demandoc.c projects/cxl_iscsi/contrib/mdocml/eqn.7 projects/cxl_iscsi/contrib/mdocml/eqn.c projects/cxl_iscsi/contrib/mdocml/eqn_term.c projects/cxl_iscsi/contrib/mdocml/example.style.css projects/cxl_iscsi/contrib/mdocml/gmdiff projects/cxl_iscsi/contrib/mdocml/html.c projects/cxl_iscsi/contrib/mdocml/libman.h projects/cxl_iscsi/contrib/mdocml/libmandoc.h projects/cxl_iscsi/contrib/mdocml/libmdoc.h projects/cxl_iscsi/contrib/mdocml/libroff.h projects/cxl_iscsi/contrib/mdocml/main.c projects/cxl_iscsi/contrib/mdocml/main.h projects/cxl_iscsi/contrib/mdocml/man-cgi.css projects/cxl_iscsi/contrib/mdocml/man.1 projects/cxl_iscsi/contrib/mdocml/man.7 projects/cxl_iscsi/contrib/mdocml/man.c projects/cxl_iscsi/contrib/mdocml/man.h projects/cxl_iscsi/contrib/mdocml/man_html.c projects/cxl_iscsi/contrib/mdocml/man_macro.c projects/cxl_iscsi/contrib/mdocml/man_term.c projects/cxl_iscsi/contrib/mdocml/man_validate.c projects/cxl_iscsi/contrib/mdocml/mandoc.1 projects/cxl_iscsi/contrib/mdocml/mandoc.3 projects/cxl_iscsi/contrib/mdocml/mandoc.c projects/cxl_iscsi/contrib/mdocml/mandoc.db.5 projects/cxl_iscsi/contrib/mdocml/mandoc.h projects/cxl_iscsi/contrib/mdocml/mandoc_char.7 projects/cxl_iscsi/contrib/mdocml/mandoc_escape.3 projects/cxl_iscsi/contrib/mdocml/mandoc_headers.3 projects/cxl_iscsi/contrib/mdocml/mandocdb.c projects/cxl_iscsi/contrib/mdocml/manpage.c projects/cxl_iscsi/contrib/mdocml/mansearch.c projects/cxl_iscsi/contrib/mdocml/mdoc.7 projects/cxl_iscsi/contrib/mdocml/mdoc.c projects/cxl_iscsi/contrib/mdocml/mdoc.h projects/cxl_iscsi/contrib/mdocml/mdoc_argv.c projects/cxl_iscsi/contrib/mdocml/mdoc_html.c projects/cxl_iscsi/contrib/mdocml/mdoc_macro.c projects/cxl_iscsi/contrib/mdocml/mdoc_man.c projects/cxl_iscsi/contrib/mdocml/mdoc_term.c projects/cxl_iscsi/contrib/mdocml/mdoc_validate.c projects/cxl_iscsi/contrib/mdocml/msec.c projects/cxl_iscsi/contrib/mdocml/out.c projects/cxl_iscsi/contrib/mdocml/preconv.c projects/cxl_iscsi/contrib/mdocml/read.c projects/cxl_iscsi/contrib/mdocml/roff.7 projects/cxl_iscsi/contrib/mdocml/roff.c projects/cxl_iscsi/contrib/mdocml/st.in projects/cxl_iscsi/contrib/mdocml/style.css projects/cxl_iscsi/contrib/mdocml/tbl.3 projects/cxl_iscsi/contrib/mdocml/tbl.7 projects/cxl_iscsi/contrib/mdocml/tbl.c projects/cxl_iscsi/contrib/mdocml/tbl_data.c projects/cxl_iscsi/contrib/mdocml/tbl_html.c projects/cxl_iscsi/contrib/mdocml/tbl_layout.c projects/cxl_iscsi/contrib/mdocml/tbl_opts.c projects/cxl_iscsi/contrib/mdocml/tbl_term.c projects/cxl_iscsi/contrib/mdocml/term.c projects/cxl_iscsi/contrib/mdocml/term.h projects/cxl_iscsi/contrib/mdocml/term_ascii.c projects/cxl_iscsi/contrib/mdocml/term_ps.c projects/cxl_iscsi/contrib/mdocml/tree.c projects/cxl_iscsi/etc/mtree/BSD.usr.dist projects/cxl_iscsi/gnu/usr.bin/binutils/doc/Makefile projects/cxl_iscsi/gnu/usr.bin/diff/Makefile projects/cxl_iscsi/gnu/usr.bin/gperf/Makefile projects/cxl_iscsi/lib/libucl/Makefile projects/cxl_iscsi/release/arm/release.sh projects/cxl_iscsi/sys/amd64/vmm/amd/svm.c projects/cxl_iscsi/sys/amd64/vmm/amd/svm_support.S projects/cxl_iscsi/sys/arm/conf/IMX6 projects/cxl_iscsi/sys/arm/include/atomic.h projects/cxl_iscsi/sys/arm/samsung/exynos/exynos5_xhci.c projects/cxl_iscsi/sys/boot/amd64/boot1.efi/generate-fat.sh projects/cxl_iscsi/sys/cam/cam_periph.c projects/cxl_iscsi/sys/cam/cam_xpt.c projects/cxl_iscsi/sys/cam/scsi/scsi_sa.c projects/cxl_iscsi/sys/dev/gpio/gpiobus.c projects/cxl_iscsi/sys/dev/gpio/gpiobusvar.h projects/cxl_iscsi/sys/dev/gpio/ofw_gpiobus.c projects/cxl_iscsi/sys/dev/usb/controller/xhci.c projects/cxl_iscsi/sys/dev/usb/controller/xhci.h projects/cxl_iscsi/sys/dev/usb/controller/xhci_pci.c projects/cxl_iscsi/sys/fs/fuse/fuse_node.c projects/cxl_iscsi/sys/fs/fuse/fuse_node.h projects/cxl_iscsi/sys/fs/fuse/fuse_vnops.c projects/cxl_iscsi/sys/net/if.c projects/cxl_iscsi/sys/net/if_clone.c projects/cxl_iscsi/sys/net/if_clone.h projects/cxl_iscsi/sys/netinet/icmp6.h projects/cxl_iscsi/sys/netinet6/nd6.c projects/cxl_iscsi/sys/netinet6/nd6.h projects/cxl_iscsi/sys/netinet6/nd6_nbr.c projects/cxl_iscsi/sys/sys/ktr_class.h projects/cxl_iscsi/tools/build/mk/OptionalObsoleteFiles.inc projects/cxl_iscsi/usr.bin/man/man.sh Directory Properties: projects/cxl_iscsi/ (props changed) projects/cxl_iscsi/contrib/binutils/ (props changed) projects/cxl_iscsi/contrib/libucl/ (props changed) projects/cxl_iscsi/contrib/mdocml/ (props changed) projects/cxl_iscsi/etc/ (props changed) projects/cxl_iscsi/gnu/usr.bin/binutils/ (props changed) projects/cxl_iscsi/sys/ (props changed) projects/cxl_iscsi/sys/amd64/vmm/ (props changed) projects/cxl_iscsi/sys/boot/ (props changed) Modified: projects/cxl_iscsi/ObsoleteFiles.inc ============================================================================== --- projects/cxl_iscsi/ObsoleteFiles.inc Mon Mar 2 22:48:11 2015 (r279554) +++ projects/cxl_iscsi/ObsoleteFiles.inc Mon Mar 2 23:03:53 2015 (r279555) @@ -38,6 +38,10 @@ # xargs -n1 | sort | uniq -d; # done +# 20150302: binutils documentation distributed as a manpage +OLD_FILES+=usr/share/doc/binutils/as.txt +OLD_FILES+=usr/share/doc/binutils/ld.txt +OLD_DIRS+=usr/share/doc/binutils # 20150222: Removed bcd(6) and ppt(6) OLD_FILES+=usr/bin/bcd OLD_FILES+=usr/bin/ppt Copied: projects/cxl_iscsi/contrib/binutils/binutils/doc/binutils.7 (from r279554, head/contrib/binutils/binutils/doc/binutils.7) ============================================================================== --- /dev/null 00:00:00 1970 (empty, because file is newly added) +++ projects/cxl_iscsi/contrib/binutils/binutils/doc/binutils.7 Mon Mar 2 23:03:53 2015 (r279555, copy of r279554, head/contrib/binutils/binutils/doc/binutils.7) @@ -0,0 +1,4917 @@ +.Dd 2015-03-02 +.Dt BINUTILS 7 +.Os +.Sh NAME +.Nm binutils +.Nd GNU Binary Utilities +.Sh Introduction +This brief manual contains documentation for the GNU binary utilities version "2.17.50 +[FreeBSD] 2007-07-03": +.Pp +This document is distributed under the terms of the GNU Free Documentation +License. A copy of the license is included in the section entitled "GNU Free +Documentation License". +.Pp +.Sh ar +.Bd -literal -offset indent +ar [-]p[mod [relpos] [count]] archive [member...] +ar -M [ <mri-script ] +.Ed +.Pp +The GNU +.Xr ar +program creates, modifies, and extracts from archives. An +.Em archive +is a single file holding a collection of other files in a structure that makes +it possible to retrieve the original individual files (called +.Em members +of the archive). +.Pp +The original files' contents, mode (permissions), timestamp, owner, and group +are preserved in the archive, and can be restored on extraction. +.Pp +GNU +.Xr ar +can maintain archives whose members have names of any length; however, depending +on how +.Xr ar +is configured on your system, a limit on member-name length may be imposed +for compatibility with archive formats maintained with other tools. If it +exists, the limit is often 15 characters (typical of formats related to a.out) +or 16 characters (typical of formats related to coff). +.Pp +.Xr ar +is considered a binary utility because archives of this sort are most often +used as +.Em libraries +holding commonly needed subroutines. +.Pp +.Xr ar +creates an index to the symbols defined in relocatable object modules in the +archive when you specify the modifier +.Li s . +Once created, this index is updated in the archive whenever +.Xr ar +makes a change to its contents (save for the +.Li q +update operation). An archive with such an index speeds up linking to the +library, and allows routines in the library to call each other without regard +to their placement in the archive. +.Pp +You may use +.Li nm -s +or +.Li nm --print-armap +to list this index table. If an archive lacks the table, another form of +.Xr ar +called +.Xr ranlib +can be used to add just the table. +.Pp +GNU +.Xr ar +is designed to be compatible with two different facilities. You can control +its activity using command-line options, like the different varieties of +.Xr ar +on Unix systems; or, if you specify the single command-line option +.Op -M , +you can control it with a script supplied via standard input, like the MRI +\(lqlibrarian\(rq program. +.Pp +.Ss Controlling Xr ar on the Command Line +.Bd -literal -offset indent +ar [-X32_64] [-]p[mod [relpos] [count]] archive [member...] +.Ed +.Pp +When you use +.Xr ar +in the Unix style, +.Xr ar +insists on at least two arguments to execute: one keyletter specifying the +.Em operation +(optionally accompanied by other keyletters specifying +.Em modifiers ) , +and the archive name to act on. +.Pp +Most operations can also accept further +.Va member +arguments, specifying particular files to operate on. +.Pp +GNU +.Xr ar +allows you to mix the operation code +.Va p +and modifier flags +.Va mod +in any order, within the first command-line argument. +.Pp +If you wish, you may begin the first command-line argument with a dash. +.Pp +The +.Va p +keyletter specifies what operation to execute; it may be any of the following, +but you must specify only one of them: +.Pp +.Bl -tag -width Ds +.It d +.Em Delete +modules from the archive. Specify the names of modules to be deleted as +.Va member +\&...; the archive is untouched if you specify no files to delete. +.Pp +If you specify the +.Li v +modifier, +.Xr ar +lists each module as it is deleted. +.Pp +.It m +Use this operation to +.Em move +members in an archive. +.Pp +The ordering of members in an archive can make a difference in how programs +are linked using the library, if a symbol is defined in more than one member. +.Pp +If no modifiers are used with +.Li m , +any members you name in the +.Va member +arguments are moved to the +.Em end +of the archive; you can use the +.Li a , +.Li b , +or +.Li i +modifiers to move them to a specified place instead. +.Pp +.It p +.Em Print +the specified members of the archive, to the standard output file. If the +.Li v +modifier is specified, show the member name before copying its contents to +standard output. +.Pp +If you specify no +.Va member +arguments, all the files in the archive are printed. +.Pp +.It q +.Em Quick append ; +Historically, add the files +.Va member +\&...to the end of +.Va archive , +without checking for replacement. +.Pp +The modifiers +.Li a , +.Li b , +and +.Li i +do +.Em not +affect this operation; new members are always placed at the end of the archive. +.Pp +The modifier +.Li v +makes +.Xr ar +list each file as it is appended. +.Pp +Since the point of this operation is speed, the archive's symbol table index +is not updated, even if it already existed; you can use +.Li ar s +or +.Xr ranlib +explicitly to update the symbol table index. +.Pp +However, too many different systems assume quick append rebuilds the index, +so GNU +.Xr ar +implements +.Li q +as a synonym for +.Li r . +.Pp +.It r +Insert the files +.Va member +\&...into +.Va archive +(with +.Em replacement ) . +This operation differs from +.Li q +in that any previously existing members are deleted if their names match those +being added. +.Pp +If one of the files named in +.Va member +\&...does not exist, +.Xr ar +displays an error message, and leaves undisturbed any existing members of +the archive matching that name. +.Pp +By default, new members are added at the end of the file; but you may use +one of the modifiers +.Li a , +.Li b , +or +.Li i +to request placement relative to some existing member. +.Pp +The modifier +.Li v +used with this operation elicits a line of output for each file inserted, +along with one of the letters +.Li a +or +.Li r +to indicate whether the file was appended (no old member deleted) or replaced. +.Pp +.It t +Display a +.Em table +listing the contents of +.Va archive , +or those of the files listed in +.Va member +\&...that are present in the archive. Normally only the member name is shown; if +you also want to see the modes (permissions), timestamp, owner, group, and +size, you can request that by also specifying the +.Li v +modifier. +.Pp +If you do not specify a +.Va member , +all files in the archive are listed. +.Pp +If there is more than one file with the same name (say, +.Li fie ) +in an archive (say +.Li b.a ) , +.Li ar t b.a fie +lists only the first instance; to see them all, you must ask for a complete +listing---in our example, +.Li ar t b.a . +.Pp +.It x +.Em Extract +members (named +.Va member ) +from the archive. You can use the +.Li v +modifier with this operation, to request that +.Xr ar +list each name as it extracts it. +.Pp +If you do not specify a +.Va member , +all files in the archive are extracted. +.Pp +.El +A number of modifiers ( +.Va mod ) +may immediately follow the +.Va p +keyletter, to specify variations on an operation's behavior: +.Pp +.Bl -tag -width Ds +.It a +Add new files +.Em after +an existing member of the archive. If you use the modifier +.Li a , +the name of an existing archive member must be present as the +.Va relpos +argument, before the +.Va archive +specification. +.Pp +.It b +Add new files +.Em before +an existing member of the archive. If you use the modifier +.Li b , +the name of an existing archive member must be present as the +.Va relpos +argument, before the +.Va archive +specification. (same as +.Li i ) . +.Pp +.It c +.Em Create +the archive. The specified +.Va archive +is always created if it did not exist, when you request an update. But a warning +is issued unless you specify in advance that you expect to create it, by using +this modifier. +.Pp +.It f +Truncate names in the archive. GNU +.Xr ar +will normally permit file names of any length. This will cause it to create +archives which are not compatible with the native +.Xr ar +program on some systems. If this is a concern, the +.Li f +modifier may be used to truncate file names when putting them in the archive. +.Pp +.It i +Insert new files +.Em before +an existing member of the archive. If you use the modifier +.Li i , +the name of an existing archive member must be present as the +.Va relpos +argument, before the +.Va archive +specification. (same as +.Li b ) . +.Pp +.It l +This modifier is accepted but not used. +.Pp +.It N +Uses the +.Va count +parameter. This is used if there are multiple entries in the archive with +the same name. Extract or delete instance +.Va count +of the given name from the archive. +.Pp +.It o +Preserve the +.Em original +dates of members when extracting them. If you do not specify this modifier, +files extracted from the archive are stamped with the time of extraction. +.Pp +.It P +Use the full path name when matching names in the archive. GNU +.Xr ar +can not create an archive with a full path name (such archives are not POSIX +complaint), but other archive creators can. This option will cause GNU +.Xr ar +to match file names using a complete path name, which can be convenient when +extracting a single file from an archive created by another tool. +.Pp +.It s +Write an object-file index into the archive, or update an existing one, even +if no other change is made to the archive. You may use this modifier flag +either with any operation, or alone. Running +.Li ar s +on an archive is equivalent to running +.Li ranlib +on it. +.Pp +.It S +Do not generate an archive symbol table. This can speed up building a large +library in several steps. The resulting archive can not be used with the linker. +In order to build a symbol table, you must omit the +.Li S +modifier on the last execution of +.Li ar , +or you must run +.Li ranlib +on the archive. +.Pp +.It u +Normally, +.Li ar r +\&...inserts all files listed into the archive. If you would like to insert +.Em only +those of the files you list that are newer than existing members of the same +names, use this modifier. The +.Li u +modifier is allowed only for the operation +.Li r +(replace). In particular, the combination +.Li qu +is not allowed, since checking the timestamps would lose any speed advantage +from the operation +.Li q . +.Pp +.It v +This modifier requests the +.Em verbose +version of an operation. Many operations display additional information, such +as filenames processed, when the modifier +.Li v +is appended. +.Pp +.It V +This modifier shows the version number of +.Xr ar . +.El +.Pp +.Xr ar +ignores an initial option spelt +.Li -X32_64 , +for compatibility with AIX. The behaviour produced by this option is the default +for GNU +.Xr ar . +.Xr ar +does not support any of the other +.Li -X +options; in particular, it does not support +.Op -X32 +which is the default for AIX +.Xr ar . +.Pp +.Ss Controlling Xr ar with a Script +.Bd -literal -offset indent +ar -M [ <script ] +.Ed +.Pp +If you use the single command-line option +.Li -M +with +.Xr ar , +you can control its operation with a rudimentary command language. This form +of +.Xr ar +operates interactively if standard input is coming directly from a terminal. +During interactive use, +.Xr ar +prompts for input (the prompt is +.Li AR > ) , +and continues executing even after errors. If you redirect standard input +to a script file, no prompts are issued, and +.Xr ar +abandons execution (with a nonzero exit code) on any error. +.Pp +The +.Xr ar +command language is +.Em not +designed to be equivalent to the command-line options; in fact, it provides +somewhat less control over archives. The only purpose of the command language +is to ease the transition to GNU +.Xr ar +for developers who already have scripts written for the MRI \(lqlibrarian\(rq program. +.Pp +The syntax for the +.Xr ar +command language is straightforward: +.Bl -bullet +.It +commands are recognized in upper or lower case; for example, +.Li LIST +is the same as +.Li list . +In the following descriptions, commands are shown in upper case for clarity. +.Pp +.It +a single command may appear on each line; it is the first word on the line. +.Pp +.It +empty lines are allowed, and have no effect. +.Pp +.It +comments are allowed; text after either of the characters +.Li * +or +.Li ; +is ignored. +.Pp +.It +Whenever you use a list of names as part of the argument to an +.Xr ar +command, you can separate the individual names with either commas or blanks. +Commas are shown in the explanations below, for clarity. +.Pp +.It +.Li + +is used as a line continuation character; if +.Li + +appears at the end of a line, the text on the following line is considered +part of the current command. +.El +.Pp +Here are the commands you can use in +.Xr ar +scripts, or when using +.Xr ar +interactively. Three of them have special significance: +.Pp +.Li OPEN +or +.Li CREATE +specify a +.Em current archive , +which is a temporary file required for most of the other commands. +.Pp +.Li SAVE +commits the changes so far specified by the script. Prior to +.Li SAVE , +commands affect only the temporary copy of the current archive. +.Pp +.Bl -tag -width Ds +.It ADDLIB Va archive +.It ADDLIB Va archive ( Va module, Va module, ... Va module) +Add all the contents of +.Va archive +(or, if specified, each named +.Va module +from +.Va archive ) +to the current archive. +.Pp +Requires prior use of +.Li OPEN +or +.Li CREATE . +.Pp +.It ADDMOD Va member, Va member, ... Va member +Add each named +.Va member +as a module in the current archive. +.Pp +Requires prior use of +.Li OPEN +or +.Li CREATE . +.Pp +.It CLEAR +Discard the contents of the current archive, canceling the effect of any operations +since the last +.Li SAVE . +May be executed (with no effect) even if no current archive is specified. +.Pp +.It CREATE Va archive +Creates an archive, and makes it the current archive (required for many other +commands). The new archive is created with a temporary name; it is not actually +saved as +.Va archive +until you use +.Li SAVE . +You can overwrite existing archives; similarly, the contents of any existing +file named +.Va archive +will not be destroyed until +.Li SAVE . +.Pp +.It DELETE Va module, Va module, ... Va module +Delete each listed +.Va module +from the current archive; equivalent to +.Li ar -d Va archive Va module ... Va module . +.Pp +Requires prior use of +.Li OPEN +or +.Li CREATE . +.Pp +.It DIRECTORY Va archive ( Va module, ... Va module) +.It DIRECTORY Va archive ( Va module, ... Va module) Va outputfile +List each named +.Va module +present in +.Va archive . +The separate command +.Li VERBOSE +specifies the form of the output: when verbose output is off, output is like +that of +.Li ar -t Va archive Va module... . +When verbose output is on, the listing is like +.Li ar -tv Va archive Va module... . +.Pp +Output normally goes to the standard output stream; however, if you specify +.Va outputfile +as a final argument, +.Xr ar +directs the output to that file. +.Pp +.It END +Exit from +.Xr ar , +with a +.Li 0 +exit code to indicate successful completion. This command does not save the +output file; if you have changed the current archive since the last +.Li SAVE +command, those changes are lost. +.Pp +.It EXTRACT Va module, Va module, ... Va module +Extract each named +.Va module +from the current archive, writing them into the current directory as separate +files. Equivalent to +.Li ar -x Va archive Va module... . +.Pp +Requires prior use of +.Li OPEN +or +.Li CREATE . +.Pp +.It LIST +Display full contents of the current archive, in \(lqverbose\(rq style regardless +of the state of +.Li VERBOSE . +The effect is like +.Li ar tv Va archive . +(This single command is a GNU +.Xr ar +enhancement, rather than present for MRI compatibility.) +.Pp +Requires prior use of +.Li OPEN +or +.Li CREATE . +.Pp +.It OPEN Va archive +Opens an existing archive for use as the current archive (required for many +other commands). Any changes as the result of subsequent commands will not +actually affect +.Va archive +until you next use +.Li SAVE . +.Pp +.It REPLACE Va module, Va module, ... Va module +In the current archive, replace each existing +.Va module +(named in the +.Li REPLACE +arguments) from files in the current working directory. To execute this command +without errors, both the file, and the module in the current archive, must +exist. +.Pp +Requires prior use of +.Li OPEN +or +.Li CREATE . +.Pp +.It VERBOSE +Toggle an internal flag governing the output from +.Li DIRECTORY . +When the flag is on, +.Li DIRECTORY +output matches output from +.Li ar -tv +\&...\&. +.Pp +.It SAVE +Commit your changes to the current archive, and actually save it as a file +with the name specified in the last +.Li CREATE +or +.Li OPEN +command. +.Pp +Requires prior use of +.Li OPEN +or +.Li CREATE . +.Pp +.El +.Sh nm +.Bd -literal -offset indent +nm [-a|--debug-syms] [-g|--extern-only] + [-B] [-C|--demangle[=style]] [-D|--dynamic] + [-S|--print-size] [-s|--print-armap] + [-A|-o|--print-file-name][--special-syms] + [-n|-v|--numeric-sort] [-p|--no-sort] + [-r|--reverse-sort] [--size-sort] [-u|--undefined-only] + [-t radix|--radix=radix] [-P|--portability] + [--target=bfdname] [-fformat|--format=format] + [--defined-only] [-l|--line-numbers] [--no-demangle] + [-V|--version] [-X 32_64] [--help] [objfile...] +.Ed +.Pp +GNU +.Xr nm +lists the symbols from object files +.Va objfile +\&...\&. If no object files are listed as arguments, +.Xr nm +assumes the file +.Pa a.out . +.Pp +For each symbol, +.Xr nm +shows: +.Pp +.Bl -bullet +.It +The symbol value, in the radix selected by options (see below), or hexadecimal +by default. +.Pp +.It +The symbol type. At least the following types are used; others are, as well, +depending on the object file format. If lowercase, the symbol is local; if +uppercase, the symbol is global (external). +.Pp +.Bl -tag -width Ds +.It A +The symbol's value is absolute, and will not be changed by further linking. +.Pp +.It B +The symbol is in the uninitialized data section (known as BSS). +.Pp +.It C +The symbol is common. Common symbols are uninitialized data. When linking, +multiple common symbols may appear with the same name. If the symbol is defined +anywhere, the common symbols are treated as undefined references. For more +details on common symbols, see the discussion of --warn-common in Options,,Linker +options,ld.info,The GNU linker. +.Pp +.It D +The symbol is in the initialized data section. +.Pp +.It G +The symbol is in an initialized data section for small objects. Some object +file formats permit more efficient access to small data objects, such as a +global int variable as opposed to a large global array. +.Pp +.It I +The symbol is an indirect reference to another symbol. This is a GNU extension +to the a.out object file format which is rarely used. +.Pp +.It N +The symbol is a debugging symbol. +.Pp +.It R +The symbol is in a read only data section. +.Pp +.It S +The symbol is in an uninitialized data section for small objects. +.Pp +.It T +The symbol is in the text (code) section. +.Pp +.It U +The symbol is undefined. +.Pp +.It V +The symbol is a weak object. When a weak defined symbol is linked with a normal +defined symbol, the normal defined symbol is used with no error. When a weak +undefined symbol is linked and the symbol is not defined, the value of the +weak symbol becomes zero with no error. +.Pp +.It W +The symbol is a weak symbol that has not been specifically tagged as a weak +object symbol. When a weak defined symbol is linked with a normal defined +symbol, the normal defined symbol is used with no error. When a weak undefined +symbol is linked and the symbol is not defined, the value of the symbol is +determined in a system-specific manner without error. On some systems, uppercase +indicates that a default value has been specified. +.Pp +.It - +The symbol is a stabs symbol in an a.out object file. In this case, the next +values printed are the stabs other field, the stabs desc field, and the stab +type. Stabs symbols are used to hold debugging information. For more information, +see Top,Stabs,Stabs Overview,stabs.info, The \(lqstabs\(rq debug format. +.Pp +.It ? +The symbol type is unknown, or object file format specific. +.El +.Pp +.It +The symbol name. +.El +.Pp +The long and short forms of options, shown here as alternatives, are equivalent. +.Pp +.Bl -tag -width Ds +.It -A +.It -o +.It --print-file-name +Precede each symbol by the name of the input file (or archive member) in which +it was found, rather than identifying the input file once only, before all +of its symbols. +.Pp +.It -a +.It --debug-syms +Display all symbols, even debugger-only symbols; normally these are not listed. +.Pp +.It -B +The same as +.Op --format=bsd +(for compatibility with the MIPS +.Xr nm ) . +.Pp +.It -C +.It --demangle[= Va style] +Decode ( +.Em demangle ) +low-level symbol names into user-level names. Besides removing any initial +underscore prepended by the system, this makes C++ function names readable. +Different compilers have different mangling styles. The optional demangling +style argument can be used to choose an appropriate demangling style for your +compiler.See Section +.Dq c++filt , +for more information on demangling. +.Pp +.It --no-demangle +Do not demangle low-level symbol names. This is the default. +.Pp +.It -D +.It --dynamic +Display the dynamic symbols rather than the normal symbols. This is only meaningful +for dynamic objects, such as certain types of shared libraries. +.Pp +.It -f Va format +.It --format= Va format +Use the output format +.Va format , +which can be +.Li bsd , +.Li sysv , +or +.Li posix . +The default is +.Li bsd . +Only the first character of +.Va format +is significant; it can be either upper or lower case. +.Pp +.It -g +.It --extern-only +Display only external symbols. +.Pp +.It -l +.It --line-numbers +For each symbol, use debugging information to try to find a filename and line +number. For a defined symbol, look for the line number of the address of the +symbol. For an undefined symbol, look for the line number of a relocation +entry which refers to the symbol. If line number information can be found, +print it after the other symbol information. +.Pp +.It -n +.It -v +.It --numeric-sort +Sort symbols numerically by their addresses, rather than alphabetically by +their names. +.Pp +.It -p +.It --no-sort +Do not bother to sort the symbols in any order; print them in the order encountered. +.Pp +.It -P +.It --portability +Use the POSIX.2 standard output format instead of the default format. Equivalent +to +.Li -f posix . +.Pp +.It -S +.It --print-size +Print size, not the value, of defined symbols for the +.Li bsd +output format. +.Pp +.It -s +.It --print-armap +When listing symbols from archive members, include the index: a mapping (stored +in the archive by +.Xr ar +or +.Xr ranlib ) +of which modules contain definitions for which names. +.Pp +.It -r +.It --reverse-sort +Reverse the order of the sort (whether numeric or alphabetic); let the last +come first. +.Pp +.It --size-sort +Sort symbols by size. The size is computed as the difference between the value +of the symbol and the value of the symbol with the next higher value. If the +.Li bsd +output format is used the size of the symbol is printed, rather than the value, +and +.Li -S +must be used in order both size and value to be printed. +.Pp +.It --special-syms +Display symbols which have a target-specific special meaning. These symbols +are usually used by the target for some special processing and are not normally +helpful when included included in the normal symbol lists. For example for +ARM targets this option would skip the mapping symbols used to mark transitions +between ARM code, THUMB code and data. +.Pp +.It -t Va radix +.It --radix= Va radix +Use +.Va radix +as the radix for printing the symbol values. It must be +.Li d +for decimal, +.Li o +for octal, or +.Li x +for hexadecimal. +.Pp +.It --target= Va bfdname +Specify an object code format other than your system's default format.See Section +.Dq Target Selection , +for more information. +.Pp +.It -u +.It --undefined-only +Display only undefined symbols (those external to each object file). +.Pp +.It --defined-only +Display only defined symbols for each object file. +.Pp +.It -V +.It --version +Show the version number of +.Xr nm +and exit. +.Pp +.It -X +This option is ignored for compatibility with the AIX version of +.Xr nm . +It takes one parameter which must be the string +.Op 32_64 . +The default mode of AIX +.Xr nm +corresponds to +.Op -X 32 , +which is not supported by GNU +.Xr nm . +.Pp +.It --help +Show a summary of the options to +.Xr nm +and exit. +.El +.Pp +.Sh objcopy +.Bd -literal -offset indent +objcopy [-F bfdname|--target=bfdname] + [-I bfdname|--input-target=bfdname] + [-O bfdname|--output-target=bfdname] + [-B bfdarch|--binary-architecture=bfdarch] + [-S|--strip-all] + [-g|--strip-debug] + [-K symbolname|--keep-symbol=symbolname] + [-N symbolname|--strip-symbol=symbolname] + [--strip-unneeded-symbol=symbolname] + [-G symbolname|--keep-global-symbol=symbolname] + [--localize-hidden] + [-L symbolname|--localize-symbol=symbolname] + [--globalize-symbol=symbolname] + [-W symbolname|--weaken-symbol=symbolname] + [-w|--wildcard] + [-x|--discard-all] + [-X|--discard-locals] + [-b byte|--byte=byte] + [-i interleave|--interleave=interleave] + [-j sectionname|--only-section=sectionname] + [-R sectionname|--remove-section=sectionname] + [-p|--preserve-dates] + [--debugging] + [--gap-fill=val] + [--pad-to=address] + [--set-start=val] + [--adjust-start=incr] + [--change-addresses=incr] + [--change-section-address section{=,+,-}val] + [--change-section-lma section{=,+,-}val] + [--change-section-vma section{=,+,-}val] + [--change-warnings] [--no-change-warnings] + [--set-section-flags section=flags] + [--add-section sectionname=filename] + [--rename-section oldname=newname[,flags]] + [--change-leading-char] [--remove-leading-char] + [--reverse-bytes=num] + [--srec-len=ival] [--srec-forceS3] + [--redefine-sym old=new] + [--redefine-syms=filename] *** DIFF OUTPUT TRUNCATED AT 1000 LINES ***
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201503022303.t22N3sQf060940>