From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 107451 invoked by alias); 26 Oct 2016 09:53:36 -0000 Mailing-List: contact libc-alpha-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: libc-alpha-owner@sourceware.org Received: (qmail 104074 invoked by uid 89); 26 Oct 2016 09:53:31 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-1.1 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_NONE,SPF_NEUTRAL autolearn=no version=3.3.2 spammy=Hx-languages-length:1696, @env, recommended X-HELO: homiemail-a42.g.dreamhost.com Reply-To: siddhesh@sourceware.org Subject: Re: [PATCH 6/6] User manual documentation for tunables References: <1477320168-23397-1-git-send-email-siddhesh@sourceware.org> <1477320168-23397-7-git-send-email-siddhesh@sourceware.org> To: Joseph Myers Cc: libc-alpha@sourceware.org From: Siddhesh Poyarekar Message-ID: <963f665f-2263-e265-ac67-cfe6b19accb8@sourceware.org> Date: Wed, 26 Oct 2016 09:53:00 -0000 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Thunderbird/45.2.0 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: 7bit X-SW-Source: 2016-10/txt/msg00452.txt.bz2 On Monday 24 October 2016 10:51 PM, Joseph Myers wrote: > On Mon, 24 Oct 2016, Siddhesh Poyarekar wrote: > >> +the @code{GLIBC_TUNABLES} environment variable by setting it to a string > > @env. > >> +of colon-separated @code{name=value} pairs. For example, the following > > @var{name}=@var{value}. > >> +It is possible to implement multiple 'frontends' for the tunables allowing > > Use ` as opening quote in Texinfo. > >> +@itemize @bullet >> +@item @var{0} Disable all error reporting. The alternate allocator is selected >> +and heap corruption detection is in place, but any such errors detected are >> +ignored. This is currently a supported use, but is not recommended. >> +@item @var{1} Report errors. The alternate allocator is selected and heap >> +corruption, if detected, is reported as diagnostic messages to @var{stderr} and >> +the program continues execution. >> +@item @var{2} Abort on errors. The alternate allocator is selected and if heap >> +corruption is detected, the program is ended immediately by calling >> +@code{abort}. >> +@item @var{3} Fully enabled. The alternate allocator is selected and is fully >> +functional. That is, if heap corruption is detected, a verbose diagnostic >> +message is printed to @var{stderr} and the program is ended by calling >> +@code{abort}. >> +@end itemize > > @var is for metasyntactic variables. It is not for names of literal C > language entities such as stderr (use @code) or for integers such as 0, 1, > 2, 3. > >> +diverges from normal program behavior by writing to @var{stderr}, which could > > Likewise. > Thanks, fixed all this and more in my local copy. Siddhesh