From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 103304 invoked by alias); 10 Apr 2017 14:56:48 -0000 Mailing-List: contact binutils-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: binutils-owner@sourceware.org Received: (qmail 101682 invoked by uid 89); 10 Apr 2017 14:56:47 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-26.9 required=5.0 tests=BAYES_00,GIT_PATCH_0,GIT_PATCH_1,GIT_PATCH_2,GIT_PATCH_3,RP_MATCHES_RCVD,SPF_HELO_PASS autolearn=ham version=3.3.2 spammy= X-HELO: mx1.redhat.com Received: from mx1.redhat.com (HELO mx1.redhat.com) (209.132.183.28) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Mon, 10 Apr 2017 14:56:46 +0000 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 9BE49C059725 for ; Mon, 10 Apr 2017 14:56:46 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mx1.redhat.com 9BE49C059725 Authentication-Results: ext-mx08.extmail.prod.ext.phx2.redhat.com; dmarc=none (p=none dis=none) header.from=redhat.com Authentication-Results: ext-mx08.extmail.prod.ext.phx2.redhat.com; spf=pass smtp.mailfrom=nickc@redhat.com DKIM-Filter: OpenDKIM Filter v2.11.0 mx1.redhat.com 9BE49C059725 Received: from snowball.redhat.com (ovpn-117-92.ams2.redhat.com [10.36.117.92]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 10EC66031D for ; Mon, 10 Apr 2017 14:56:45 +0000 (UTC) From: Nick Clifton To: binutils@sourceware.org Subject: Commit: Add missing linker command line options to linker documentation Date: Mon, 10 Apr 2017 14:56:00 -0000 Message-ID: <87fuhgz4yb.fsf@redhat.com> MIME-Version: 1.0 Content-Type: text/plain X-IsSubscribed: yes X-SW-Source: 2017-04/txt/msg00100.txt.bz2 Hi Guys, I am applying the patch below to add some documentation for a few linker command line options which appear to have slipped through the gaps. Cheers Nick 2017-04-10 Nick Clifton * ld.texinfo (--strip-discarded): Document. (--embedded-relocs): Document. (--spare-dynamic-tags): Document. (--task-link): Document. diff --git a/ld/ld.texinfo b/ld/ld.texinfo index 769725d..909342c 100644 --- a/ld/ld.texinfo +++ b/ld/ld.texinfo @@ -943,6 +943,13 @@ Omit all symbol information from the output file. @itemx --strip-debug Omit debugger symbol information (but not all symbols) from the output file. +@kindex --strip-discarded +@kindex --no-strip-discarded +@item --strip-discarded +@itemx --no-strip-discarded +Omit (or do not omit) global symbols defined in discarded sections. +Enabled by default. + @kindex -t @kindex --trace @cindex input files, displaying @@ -1518,6 +1525,13 @@ linker to be used at load-time. This is only meaningful for ELF executables that contain dynamic relocations, and usually requires entry point code that is capable of processing these relocations. +@kindex --embedded-relocs +@item --embedded-relocs +This option is similar to the @option{--emit-relocs} option except +that the relocs are stored in a target specific section. This option +is only supported by the @samp{BFIN}, @samp{CR16} and @emph{M68K} +targets. + @kindex --fatal-warnings @kindex --no-fatal-warnings @item --fatal-warnings @@ -1979,6 +1993,12 @@ patterns in the linker script. This option will apply @code{SORT_BY_ALIGNMENT} to all wildcard section patterns in the linker script. +@kindex --spare-dynamic-tags +@item --spare-dynamic-tags=@var{count} +This option specifies the number of empty slots to leave in the +.dynamic section of ELF shared objects. Empty slots may be needed by +post processing tools, such as the prelinker. The default is 5. + @kindex --split-by-file @item --split-by-file[=@var{size}] Similar to @option{--split-by-reloc} but creates a new output section for @@ -2009,6 +2029,11 @@ Use @var{directory} as the location of the sysroot, overriding the configure-time default. This option is only supported by linkers that were configured using @option{--with-sysroot}. +@kindex --task-link +@item --task-link +This is used by COFF/PE based targets to create a task-linked object +file where all of the global symbols have been converted to statics. + @kindex --traditional-format @cindex traditional format @item --traditional-format