Re: [PATCH] lib: fix warnings when building with clang
authorJani Nikula <jani@nikula.org>
Sun, 21 Oct 2012 18:44:17 +0000 (21:44 +0300)
committerW. Trevor King <wking@tremily.us>
Fri, 7 Nov 2014 17:49:57 +0000 (09:49 -0800)
52/e508a4c7c866e13907ffe956e7791051849fcd [new file with mode: 0644]

diff --git a/52/e508a4c7c866e13907ffe956e7791051849fcd b/52/e508a4c7c866e13907ffe956e7791051849fcd
new file mode 100644 (file)
index 0000000..26a14d9
--- /dev/null
@@ -0,0 +1,148 @@
+Return-Path: <jani@nikula.org>\r
+X-Original-To: notmuch@notmuchmail.org\r
+Delivered-To: notmuch@notmuchmail.org\r
+Received: from localhost (localhost [127.0.0.1])\r
+       by olra.theworths.org (Postfix) with ESMTP id 67391431FAF\r
+       for <notmuch@notmuchmail.org>; Sun, 21 Oct 2012 11:44:25 -0700 (PDT)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: -0.7\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5\r
+       tests=[RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled\r
+Received: from olra.theworths.org ([127.0.0.1])\r
+       by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
+       with ESMTP id Ie8enu8O8nhj for <notmuch@notmuchmail.org>;\r
+       Sun, 21 Oct 2012 11:44:24 -0700 (PDT)\r
+Received: from mail-la0-f53.google.com (mail-la0-f53.google.com\r
+       [209.85.215.53]) (using TLSv1 with cipher RC4-SHA (128/128 bits))\r
+       (No client certificate requested)\r
+       by olra.theworths.org (Postfix) with ESMTPS id 7FA81431FAE\r
+       for <notmuch@notmuchmail.org>; Sun, 21 Oct 2012 11:44:24 -0700 (PDT)\r
+Received: by mail-la0-f53.google.com with SMTP id l5so1405262lah.26\r
+       for <notmuch@notmuchmail.org>; Sun, 21 Oct 2012 11:44:21 -0700 (PDT)\r
+X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;\r
+       d=google.com; s=20120113;\r
+       h=from:to:subject:in-reply-to:references:user-agent:date:message-id\r
+       :mime-version:content-type:x-gm-message-state;\r
+       bh=LwZFQlgY5/Io+ENbkeV45QkSyOZiuV95gmvU4ddhMZA=;\r
+       b=hdxbjHFWAEQZbbYFNjrdJ0Sopp4g60eVx+ID8NrL5MIKmy4cNWUW1nCQAJS2FTmOpn\r
+       6lpS3jIcE8wPvsvGNBSmjlED36ZFq5BhOednrT8W8H+ngnhYejRLrGChFXzOrcl4ToTe\r
+       /c03CDPk6ZZ51Sdat29qBo8iBgDt7XpSdfMPUXK+ij/8RviFZ4NR6HalMdD43GQrqXOH\r
+       cyLZ7ZNUe8e4QYHCuameSCzcsEuOcGu6IjgtIL2gCqj6qfJx0dsQ7c7O7bcf661GJmJc\r
+       W6HNld1MIoUsfmzjwwHBNJsYbkXdfR9P9xKZCo5aiayWicRjyYLtYmZCOGiKY9kvXqZn\r
+       4npA==\r
+Received: by 10.112.39.233 with SMTP id s9mr2838268lbk.71.1350845061406;\r
+       Sun, 21 Oct 2012 11:44:21 -0700 (PDT)\r
+Received: from localhost (dsl-hkibrasgw4-fe51df00-27.dhcp.inet.fi.\r
+       [80.223.81.27])\r
+       by mx.google.com with ESMTPS id z9sm2393891lbk.15.2012.10.21.11.44.18\r
+       (version=SSLv3 cipher=OTHER); Sun, 21 Oct 2012 11:44:20 -0700 (PDT)\r
+From: Jani Nikula <jani@nikula.org>\r
+To: Ethan Glasser-Camp <ethan.glasser.camp@gmail.com>, notmuch@notmuchmail.org\r
+Subject: Re: [PATCH] lib: fix warnings when building with clang\r
+In-Reply-To: <87pq4c61hc.fsf@betacantrips.com>\r
+References: <1349076971-2065-1-git-send-email-jani@nikula.org>\r
+       <87pq4c61hc.fsf@betacantrips.com>\r
+User-Agent: Notmuch/0.14+46~g272a1f1 (http://notmuchmail.org) Emacs/23.4.1\r
+       (i686-pc-linux-gnu)\r
+Date: Sun, 21 Oct 2012 21:44:17 +0300\r
+Message-ID: <87vce3vf5q.fsf@nikula.org>\r
+MIME-Version: 1.0\r
+Content-Type: text/plain; charset=us-ascii\r
+X-Gm-Message-State:\r
+ ALoCoQnf8hYYFAHRfPRTnjuR2LaJ6bOxw6qoCRdBE4nH7VJsqNj8H4i3RtETqFKywB1uvHMLIEBH\r
+X-BeenThere: notmuch@notmuchmail.org\r
+X-Mailman-Version: 2.1.13\r
+Precedence: list\r
+List-Id: "Use and development of the notmuch mail system."\r
+       <notmuch.notmuchmail.org>\r
+List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
+List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
+List-Post: <mailto:notmuch@notmuchmail.org>\r
+List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
+List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
+X-List-Received-Date: Sun, 21 Oct 2012 18:44:25 -0000\r
+\r
+On Sun, 21 Oct 2012, Ethan Glasser-Camp <ethan.glasser.camp@gmail.com> wrote:\r
+> Jani Nikula <jani@nikula.org> writes:\r
+>\r
+>> Building notmuch with CC=clang and CXX=clang++ produces the warnings:\r
+>>\r
+>> CC -O2 lib/tags.o\r
+>> lib/tags.c:43:5: warning: expression result unused [-Wunused-value]\r
+>>     talloc_steal (tags, list);\r
+>>     ^~~~~~~~~~~~~~~~~~~~~~~~~\r
+>> /usr/include/talloc.h:345:143: note: expanded from:\r
+>>   ...__location__); __talloc_steal_ret; })\r
+>>                     ^~~~~~~~~~~~~~~~~~\r
+>> 1 warning generated.\r
+>>\r
+>> CXX -O2 lib/message.o\r
+>> lib/message.cc:791:5: warning: expression result unused [-Wunused-value]\r
+>>     talloc_reference (message, message->tag_list);\r
+>>     ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\r
+>> /usr/include/talloc.h:932:36: note: expanded from:\r
+>>   ...(_TALLOC_TYPEOF(ptr))_talloc_reference_loc((ctx),(ptr), __location__)\r
+>>      ^                    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\r
+>> 1 warning generated.\r
+>>\r
+>> Check talloc_reference() return value, and explicitly ignore\r
+>> talloc_steal() return value as it has no failure modes, to silence the\r
+>> warnings.\r
+>> ---\r
+>>  lib/message.cc |    4 +++-\r
+>>  lib/tags.c     |    2 +-\r
+>>  2 files changed, 4 insertions(+), 2 deletions(-)\r
+>>\r
+>> diff --git a/lib/message.cc b/lib/message.cc\r
+>> index 978de06..320901f 100644\r
+>> --- a/lib/message.cc\r
+>> +++ b/lib/message.cc\r
+>> @@ -788,7 +788,9 @@ notmuch_message_get_tags (notmuch_message_t *message)\r
+>>       * possible to modify the message tags (which talloc_unlink's the\r
+>>       * current list from the message) while still iterating because\r
+>>       * the iterator will keep the current list alive. */\r
+>> -    talloc_reference (message, message->tag_list);\r
+>> +    if (!talloc_reference (message, message->tag_list))\r
+>> +   return NULL;\r
+>> +\r
+>>      return tags;\r
+>>  }\r
+>\r
+> Hi! What you did with talloc_steal is obviously fine. \r
+>\r
+> I'd be happier about what you did with talloc_reference() if there were\r
+> precedent, or a clearly-articulated convention for notmuch. Instead this\r
+> is the third use in the codebase that I can see, and the other two are\r
+> each unique to themselves. In mime-node.c we print an "out-of-memory"\r
+> error and in lib/filenames.c we cast (void) talloc_reference (...), I\r
+> guess figuring that we're pretty much hosed anyhow if we run out of\r
+> memory.\r
+>\r
+> Why return NULL here? It seems like if talloc_reference fails, we're\r
+> going to crash eventually, so we should print an error to explain our\r
+> impending doom. I'd guess you're uneasy printing anything from lib/, but\r
+> still want to signal an error, and the only way you can do so is to\r
+> return NULL. I guess that silences the compiler warning, but it's not\r
+> really the correct way to handle the error IMO. On the other hand, it's\r
+> such a weird corner case that I don't even think it merits a FIXME\r
+> comment.\r
+>\r
+> How about an assert instead of a return NULL?\r
+\r
+No. I don't think a library should assert, exit, or print to stderr on\r
+this sort of thing. It's up to the calling application. Even if it\r
+probably doesn't have many choices left, given how much memory\r
+talloc_reference needs (not much).\r
+\r
+Ignoring the talloc_reference return value with (void) is just wrong,\r
+and the caller of notmuch_message_get_tags should anticipate a NULL\r
+return. So IMHO that's the pragmatic thing to do in this mostly\r
+theoretical situation, the biggest change being silencing the warning.\r
+\r
+\r
+BR,\r
+Jani.\r