From owner-freebsd-arch@FreeBSD.ORG Thu Jul 31 20:58:34 2014 Return-Path: Delivered-To: arch@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id A5CEFA02; Thu, 31 Jul 2014 20:58:34 +0000 (UTC) Received: from h2.funkthat.com (gate2.funkthat.com [208.87.223.18]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (Client CN "funkthat.com", Issuer "funkthat.com" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 64D2826DB; Thu, 31 Jul 2014 20:58:33 +0000 (UTC) Received: from h2.funkthat.com (localhost [127.0.0.1]) by h2.funkthat.com (8.14.3/8.14.3) with ESMTP id s6VKwXOh034612 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Thu, 31 Jul 2014 13:58:33 -0700 (PDT) (envelope-from jmg@h2.funkthat.com) Received: (from jmg@localhost) by h2.funkthat.com (8.14.3/8.14.3/Submit) id s6VKwXG5034611; Thu, 31 Jul 2014 13:58:33 -0700 (PDT) (envelope-from jmg) Date: Thu, 31 Jul 2014 13:58:33 -0700 From: John-Mark Gurney To: Poul-Henning Kamp Subject: Re: XML Output: libxo - provide single API to output TXT, XML, JSON and HTML Message-ID: <20140731205833.GU43962@funkthat.com> Mail-Followup-To: Poul-Henning Kamp , Phil Shafer , sjg@freebsd.org, arch@freebsd.org, marcel@freebsd.org References: <20140730193819.GM43962@funkthat.com> <201407302324.s6UNOB2H087915@idle.juniper.net> <20140731175547.GO43962@funkthat.com> <58087.1406837257@critter.freebsd.dk> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <58087.1406837257@critter.freebsd.dk> User-Agent: Mutt/1.4.2.3i X-Operating-System: FreeBSD 7.2-RELEASE i386 X-PGP-Fingerprint: 54BA 873B 6515 3F10 9E88 9322 9CB1 8F74 6D3F A396 X-Files: The truth is out there X-URL: http://resnet.uoregon.edu/~gurney_j/ X-Resume: http://resnet.uoregon.edu/~gurney_j/resume.html X-TipJar: bitcoin:13Qmb6AeTgQecazTWph4XasEsP7nGRbAPE X-to-the-FBI-CIA-and-NSA: HI! HOW YA DOIN? can i haz chizburger? X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.2 (h2.funkthat.com [127.0.0.1]); Thu, 31 Jul 2014 13:58:33 -0700 (PDT) Cc: sjg@freebsd.org, arch@freebsd.org, marcel@freebsd.org, Phil Shafer X-BeenThere: freebsd-arch@freebsd.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Discussion related to FreeBSD architecture List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 31 Jul 2014 20:58:34 -0000 Poul-Henning Kamp wrote this message on Thu, Jul 31, 2014 at 20:07 +0000: > -------- > In message <20140731175547.GO43962@funkthat.com>, John-Mark Gurney writes: > >Phil Shafer wrote this message on Wed, Jul 30, 2014 at 19:24 -0400: > >> John-Mark Gurney writes: > >> >My vote would be to use and *enforce* UTF-8 by the API. That means if > >> >someone passes a string in, it must be properly formed UTF-8... > >> > >> I can certainly see making this an option, detecting the high-bit > >> and inspecting the following 1-5 bytes to ensure the corresponding > >> high two bits are set appropriately. But what action would you > >> expect the library to take when invalid strings are passed in? > > > >Return an error? printf can return an error, yet most people don't > >check it.. so no real difference in API/bugs... > > This is why we ended up with SIGPIPE in the first place. > > Can I point discreetely at sbuf(3)'s accumulative error handling > and suggest that libxo does something similar ? That way applications $ man 3 sbuf No manual entry for sbuf And looks like it isn't in libc: $ cc -o q q.c /tmp/q-41cfbe.o: In function `main': q.c:(.text+0x23): undefined reference to `sbuf_new' q.c:(.text+0x38): undefined reference to `sbuf_cat' q.c:(.text+0x4c): undefined reference to `sbuf_cat' q.c:(.text+0x58): undefined reference to `sbuf_finish' q.c:(.text+0x64): undefined reference to `sbuf_data' q.c:(.text+0x82): undefined reference to `sbuf_delete' cc: error: linker command failed with exit code 1 (use -v to see invocation) Hmm... looks like libsbuf exists, and causes the above program to compile and work... Please write a man page for sbuf(3)... Thanks. > only need to check for errors once, rather than after every single > call to every single function in the libxo library. -- John-Mark Gurney Voice: +1 415 225 5579 "All that I will do, has been done, All that I have, has not."