Re: [PATCH] lib: make notmuch shared library install_name be full path on Mac OS X
authorDavid Bremner <david@tethera.net>
Fri, 27 Feb 2015 08:24:25 +0000 (09:24 +0100)
committerW. Trevor King <wking@tremily.us>
Sat, 20 Aug 2016 21:48:11 +0000 (14:48 -0700)
02/6fcc03a8573fba4aeaddf9e0d433cfc7093483 [new file with mode: 0644]

diff --git a/02/6fcc03a8573fba4aeaddf9e0d433cfc7093483 b/02/6fcc03a8573fba4aeaddf9e0d433cfc7093483
new file mode 100644 (file)
index 0000000..25efc41
--- /dev/null
@@ -0,0 +1,201 @@
+Return-Path: <david@tethera.net>\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 5753641ED95\r
+       for <notmuch@notmuchmail.org>; Fri, 27 Feb 2015 00:31:39 -0800 (PST)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: 2.438\r
+X-Spam-Level: **\r
+X-Spam-Status: No, score=2.438 tagged_above=-999 required=5\r
+       tests=[DNS_FROM_AHBL_RHSBL=2.438] 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 SQ8IeDTzZUNm for <notmuch@notmuchmail.org>;\r
+       Fri, 27 Feb 2015 00:31:36 -0800 (PST)\r
+Received: from mx.xen14.node3324.gplhost.com (gitolite.debian.net\r
+       [87.98.215.224])\r
+       (using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits))\r
+       (No client certificate requested)\r
+       by olra.theworths.org (Postfix) with ESMTPS id DBDED431FCB\r
+       for <notmuch@notmuchmail.org>; Fri, 27 Feb 2015 00:31:35 -0800 (PST)\r
+Received: from remotemail by mx.xen14.node3324.gplhost.com with local (Exim\r
+       4.80) (envelope-from <david@tethera.net>)\r
+       id 1YRGDv-0007ug-4X; Fri, 27 Feb 2015 08:24:39 +0000\r
+Received: (nullmailer pid 6410 invoked by uid 1000); Fri, 27 Feb 2015\r
+       08:24:25 -0000\r
+From: David Bremner <david@tethera.net>\r
+To: "J. Lewis Muir" <jlmuir@imca-cat.org>, notmuch@notmuchmail.org\r
+Subject: Re: [PATCH] lib: make notmuch shared library install_name be full\r
+       path on Mac OS X\r
+In-Reply-To: <1409541227-38895-1-git-send-email-jlmuir@imca-cat.org>\r
+References: <1409541227-38895-1-git-send-email-jlmuir@imca-cat.org>\r
+User-Agent: Notmuch/0.19+48~gb74ed1c (http://notmuchmail.org) Emacs/24.4.1\r
+       (x86_64-pc-linux-gnu)\r
+Date: Fri, 27 Feb 2015 09:24:25 +0100\r
+Message-ID: <87385rkbie.fsf@maritornes.cs.unb.ca>\r
+MIME-Version: 1.0\r
+Content-Type: text/plain\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: Fri, 27 Feb 2015 08:31:39 -0000\r
+\r
+"J. Lewis Muir" <jlmuir@imca-cat.org> writes:\r
+\r
+I think Tomi and I agree the content of the patch is OK, or at least as\r
+far as we can verify. If you don't mind, could you rework the commit\r
+message a bit?\r
+\r
+this part is fine:\r
+\r
+> The install_name of libnotmuch.dylib on Mac OS X is what is written\r
+> into a program that links against it.  If it is just the name of the\r
+> shared library file, as opposed to the full path, the program won't be\r
+> able to find it when it runs and will abort.  Instead, the install_name\r
+> should be the full path to the shared library (in its final installed\r
+> location).\r
+\r
+\r
+Drop this part; it makes the commit message overwhelming, especially\r
+since most of us don't have (easy) access to a Mac.\r
+\r
+>\r
+> An example on Mac OS X Mavericks (10.9.4) follows.\r
+>\r
+> We configure, build, and install notmuch, assuming the user has write\r
+> access to /opt:\r
+>\r
+> ===\r
+> $ CFLAGS='-I/pkg/include' LDFLAGS='-L/pkg/lib' ./configure \\r
+>       --prefix=/opt/notmuch-current --without-emacs\r
+> $ make\r
+> $ make install\r
+> ===\r
+>\r
+> We inspect the installed notmuch library using the otool system program:\r
+>\r
+> ===\r
+> $ otool -L /opt/notmuch-current/lib/libnotmuch.dylib\r
+> /opt/notmuch-current/lib/libnotmuch.dylib:\r
+>   libnotmuch.3.dylib \\r
+> (compatibility version 3.1.0, current version 3.1.0)\r
+>   /pkg/lib/libgmime-2.4.2.dylib \\r
+> (compatibility version 7.0.0, current version 7.33.0)\r
+>   /pkg/lib/libgobject-2.0.0.dylib \\r
+> (compatibility version 3801.0.0, current version 3801.2.0)\r
+>   /pkg/lib/libglib-2.0.0.dylib \\r
+> (compatibility version 3801.0.0, current version 3801.2.0)\r
+>   /pkg/lib/libintl.8.dylib \\r
+> (compatibility version 10.0.0, current version 10.2.0)\r
+>   /pkg/lib/libtalloc.2.1.1.dylib \\r
+> (compatibility version 0.0.0, current version 0.0.0)\r
+>   /pkg/lib/libz.1.dylib \\r
+> (compatibility version 2.0.0, current version 2.2.0)\r
+>   /pkg/lib/libxapian.22.dylib \\r
+> (compatibility version 29.0.0, current version 29.4.0)\r
+>   /usr/lib/libc++.1.dylib \\r
+> (compatibility version 1.0.0, current version 120.0.0)\r
+>   /usr/lib/libSystem.B.dylib \\r
+> (compatibility version 1.0.0, current version 1197.1.1)\r
+> ===\r
+>\r
+> That's not good.  The second line shows the install_name, and it's not a\r
+> full path, so any program that links against it as a dependent library\r
+> will not be able to find it.\r
+>\r
+> We try running the notmuch program (which is linked against the notmuch\r
+> library), and, sure enough, it aborts:\r
+>\r
+> ===\r
+> $ /opt/notmuch-current/bin/notmuch --version\r
+> dyld: Library not loaded: libnotmuch.3.dylib\r
+>   Referenced from: /opt/notmuch-current/bin/notmuch\r
+>   Reason: image not found\r
+> Trace/BPT trap: 5\r
+> ===\r
+>\r
+> After applying this commit to fix the problem and configuring, building,\r
+> and installing again as above, the notmuch library's install_name is now\r
+> the correct full path:\r
+>\r
+> ===\r
+> $ otool -L /opt/notmuch-current/lib/libnotmuch.dylib\r
+> /opt/notmuch-current/lib/libnotmuch.dylib:\r
+>   /opt/notmuch-current/lib/libnotmuch.3.dylib \\r
+> (compatibility version 3.1.0, current version 3.1.0)\r
+>   /pkg/lib/libgmime-2.4.2.dylib \\r
+> (compatibility version 7.0.0, current version 7.33.0)\r
+>   /pkg/lib/libgobject-2.0.0.dylib \\r
+> (compatibility version 3801.0.0, current version 3801.2.0)\r
+>   /pkg/lib/libglib-2.0.0.dylib \\r
+> (compatibility version 3801.0.0, current version 3801.2.0)\r
+>   /pkg/lib/libintl.8.dylib \\r
+> (compatibility version 10.0.0, current version 10.2.0)\r
+>   /pkg/lib/libtalloc.2.1.1.dylib \\r
+> (compatibility version 0.0.0, current version 0.0.0)\r
+>   /pkg/lib/libz.1.dylib \\r
+> (compatibility version 2.0.0, current version 2.2.0)\r
+>   /pkg/lib/libxapian.22.dylib \\r
+> (compatibility version 29.0.0, current version 29.4.0)\r
+>   /usr/lib/libc++.1.dylib \\r
+> (compatibility version 1.0.0, current version 120.0.0)\r
+>   /usr/lib/libSystem.B.dylib \\r
+> (compatibility version 1.0.0, current version 1197.1.1)\r
+> ===\r
+>\r
+> And the notmuch program is able to find the notmuch library when run:\r
+>\r
+> ===\r
+> $ /opt/notmuch-current/bin/notmuch --version\r
+> notmuch 0.18.1+84~g658a00e\r
+> ===\r
+>\r
+\r
+Add a brief explanation of why Homebrew and Macports already work\r
+(a few lines summarizing the info from your followup message).\r
+\r
+Thanks!\r
+\r
+\r
+> References:\r
+>\r
+> * http://www.finkproject.org/doc/porting/porting.en.html#\\r
+> shared.build-lib\r
+>\r
+> * https://developer.apple.com/library/mac/documentation/DeveloperTools/\\r
+> Conceptual/DynamicLibraries/100-Articles/OverviewOfDynamicLibraries.html\r
+> ---\r
+>  lib/Makefile.local | 2 +-\r
+>  1 file changed, 1 insertion(+), 1 deletion(-)\r
+>\r
+> diff --git a/lib/Makefile.local b/lib/Makefile.local\r
+> index c56cba9..c83f387 100644\r
+> --- a/lib/Makefile.local\r
+> +++ b/lib/Makefile.local\r
+> @@ -27,7 +27,7 @@ LIBRARY_SUFFIX = dylib\r
+>  LINKER_NAME = libnotmuch.$(LIBRARY_SUFFIX)\r
+>  SONAME = libnotmuch.$(LIBNOTMUCH_VERSION_MAJOR).$(LIBRARY_SUFFIX)\r
+>  LIBNAME = libnotmuch.$(LIBNOTMUCH_VERSION_MAJOR).$(LIBNOTMUCH_VERSION_MINOR).$(LIBNOTMUCH_VERSION_RELEASE).$(LIBRARY_SUFFIX)\r
+> -LIBRARY_LINK_FLAG = -dynamiclib -install_name $(SONAME) -compatibility_version $(LIBNOTMUCH_VERSION_MAJOR).$(LIBNOTMUCH_VERSION_MINOR) -current_version $(LIBNOTMUCH_VERSION_MAJOR).$(LIBNOTMUCH_VERSION_MINOR).$(LIBNOTMUCH_VERSION_RELEASE)\r
+> +LIBRARY_LINK_FLAG = -dynamiclib -install_name $(libdir)/$(SONAME) -compatibility_version $(LIBNOTMUCH_VERSION_MAJOR).$(LIBNOTMUCH_VERSION_MINOR) -current_version $(LIBNOTMUCH_VERSION_MAJOR).$(LIBNOTMUCH_VERSION_MINOR).$(LIBNOTMUCH_VERSION_RELEASE)\r
+>  else\r
+>  LIBRARY_SUFFIX = so\r
+>  LINKER_NAME = libnotmuch.$(LIBRARY_SUFFIX)\r
+> -- \r
+> 1.8.5.2 (Apple Git-48)\r
+>\r
+> _______________________________________________\r
+> notmuch mailing list\r
+> notmuch@notmuchmail.org\r
+> http://notmuchmail.org/mailman/listinfo/notmuch\r