From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 42494 invoked by alias); 24 Oct 2016 17:22:09 -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 42481 invoked by uid 89); 24 Oct 2016 17:22:08 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-1.9 required=5.0 tests=AWL,BAYES_00,RCVD_IN_DNSWL_NONE,SPF_PASS,URIBL_RED autolearn=ham version=3.3.2 spammy=tunables, Fully, itemize, @bullet X-Spam-User: qpsmtpd, 2 recipients X-HELO: relay1.mentorg.com Date: Mon, 24 Oct 2016 17:22:00 -0000 From: Joseph Myers To: Siddhesh Poyarekar CC: Subject: Re: [PATCH 6/6] User manual documentation for tunables In-Reply-To: <1477320168-23397-7-git-send-email-siddhesh@sourceware.org> Message-ID: References: <1477320168-23397-1-git-send-email-siddhesh@sourceware.org> <1477320168-23397-7-git-send-email-siddhesh@sourceware.org> User-Agent: Alpine 2.20 (DEB 67 2015-01-07) MIME-Version: 1.0 Content-Type: text/plain; charset="US-ASCII" X-ClientProxiedBy: svr-ies-mbx-01.mgc.mentorg.com (139.181.222.1) To svr-ies-mbx-01.mgc.mentorg.com (139.181.222.1) X-SW-Source: 2016-10/txt/msg00397.txt.bz2 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. -- Joseph S. Myers joseph@codesourcery.com