Add write_string_to_file().
[libdcp.git] / src / util.cc
index f2728a38d25bbc042025e4e23f6def45e505d752..a920ce0eae0cb717ff78298a45df79284f34cbd6 100644 (file)
@@ -1,66 +1,99 @@
 /*
-    Copyright (C) 2012 Carl Hetherington <cth@carlh.net>
+    Copyright (C) 2012-2021 Carl Hetherington <cth@carlh.net>
 
-    This program is free software; you can redistribute it and/or modify
+    This file is part of libdcp.
+
+    libdcp is free software; you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by
     the Free Software Foundation; either version 2 of the License, or
     (at your option) any later version.
 
-    This program is distributed in the hope that it will be useful,
+    libdcp is distributed in the hope that it will be useful,
     but WITHOUT ANY WARRANTY; without even the implied warranty of
     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     GNU General Public License for more details.
 
     You should have received a copy of the GNU General Public License
-    along with this program; if not, write to the Free Software
-    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
-
+    along with libdcp.  If not, see <http://www.gnu.org/licenses/>.
+
+    In addition, as a special exception, the copyright holders give
+    permission to link the code of portions of this program with the
+    OpenSSL library under certain conditions as described in each
+    individual source file, and distribute linked combinations
+    including the two.
+
+    You must obey the GNU General Public License in all respects
+    for all of the code used other than OpenSSL.  If you modify
+    file(s) with this exception, you may extend this exception to your
+    version of the file(s), but you are not obligated to do so.  If you
+    do not wish to do so, delete this exception statement from your
+    version.  If you delete this exception statement from all source
+    files in the program, then also delete it here.
 */
 
+
 /** @file  src/util.cc
- *  @brief Utility methods.
+ *  @brief Utility methods and classes
  */
 
-#include <stdexcept>
-#include <sstream>
-#include <iostream>
-#include <iomanip>
-#include <boost/filesystem.hpp>
-#include <boost/lexical_cast.hpp>
-#include <openssl/sha.h>
-#include <libxml++/nodes/element.h>
-#include <libxml++/document.h>
+
+#include "certificate.h"
+#include "compose.hpp"
+#include "dcp_assert.h"
+#include "exceptions.h"
+#include "file.h"
+#include "filesystem.h"
+#include "language_tag.h"
+#include "openjpeg_image.h"
+#include "rating.h"
+#include "types.h"
+#include "util.h"
+#include <openjpeg.h>
+#include <asdcp/KM_util.h>
+#include <asdcp/KM_fileio.h>
+#include <asdcp/AS_DCP.h>
 #include <xmlsec/xmldsig.h>
 #include <xmlsec/dl.h>
 #include <xmlsec/app.h>
-#include "KM_util.h"
-#include "KM_fileio.h"
-#include "AS_DCP.h"
-#include "util.h"
-#include "exceptions.h"
-#include "types.h"
-#include "argb_frame.h"
-#include "certificates.h"
-#include "gamma_lut.h"
-#include "xyz_frame.h"
+#include <xmlsec/crypto.h>
+#include <libxml++/nodes/element.h>
+#include <libxml++/document.h>
+#include <openssl/sha.h>
+#include <boost/algorithm/string.hpp>
+#if BOOST_VERSION >= 106100
+#include <boost/dll/runtime_symbol_info.hpp>
+#endif
+#include <boost/filesystem.hpp>
+#include <stdexcept>
+#include <iostream>
+#include <iomanip>
+
 
 using std::string;
+using std::wstring;
 using std::cout;
-using std::stringstream;
 using std::min;
 using std::max;
-using std::list;
 using std::setw;
 using std::setfill;
-using boost::shared_ptr;
-using boost::lexical_cast;
-using namespace libdcp;
-
-/** Create a UUID.
- *  @return UUID.
+using std::ostream;
+using std::shared_ptr;
+using std::vector;
+using boost::shared_array;
+using boost::optional;
+using boost::function;
+using boost::algorithm::trim;
+using namespace dcp;
+
+
+/* Some ASDCP objects store this as a *&, for reasons which are not
+ * at all clear, so we have to keep this around forever.
  */
+ASDCP::Dictionary const* dcp::asdcp_smpte_dict = nullptr;
+
+
 string
-libdcp::make_uuid ()
+dcp::make_uuid ()
 {
        char buffer[64];
        Kumu::UUID id;
@@ -70,20 +103,28 @@ libdcp::make_uuid ()
 }
 
 
-/** Create a digest for a file.
- *  @param filename File name.
- *  @param progress Pointer to a progress reporting function, or 0.  The function will be called
- *  with a progress value between 0 and 1.
- *  @return Digest.
- */
 string
-libdcp::make_digest (string filename, boost::function<void (float)>* progress)
+dcp::make_digest (ArrayData data)
+{
+       SHA_CTX sha;
+       SHA1_Init (&sha);
+       SHA1_Update (&sha, data.data(), data.size());
+       byte_t byte_buffer[SHA_DIGEST_LENGTH];
+       SHA1_Final (byte_buffer, &sha);
+       char digest[64];
+       return Kumu::base64encode (byte_buffer, SHA_DIGEST_LENGTH, digest, 64);
+}
+
+
+string
+dcp::make_digest(boost::filesystem::path filename, function<void (int64_t, int64_t)> progress)
 {
        Kumu::FileReader reader;
-       if (ASDCP_FAILURE (reader.OpenRead (filename.c_str ()))) {
-               boost::throw_exception (FileError ("could not open file to compute digest", filename));
+       auto r = reader.OpenRead(dcp::filesystem::fix_long_path(filename).string().c_str());
+       if (ASDCP_FAILURE(r)) {
+               boost::throw_exception (FileError("could not open file to compute digest", filename, r));
        }
-       
+
        SHA_CTX sha;
        SHA1_Init (&sha);
 
@@ -92,357 +133,327 @@ libdcp::make_digest (string filename, boost::function<void (float)>* progress)
 
        Kumu::fsize_t done = 0;
        Kumu::fsize_t const size = reader.Size ();
-       while (1) {
+       while (true) {
                ui32_t read = 0;
-               Kumu::Result_t r = reader.Read (read_buffer.Data(), read_buffer.Capacity(), &read);
-               
+               auto r = reader.Read (read_buffer.Data(), read_buffer.Capacity(), &read);
+
                if (r == Kumu::RESULT_ENDOFFILE) {
                        break;
                } else if (ASDCP_FAILURE (r)) {
-                       boost::throw_exception (FileError ("could not read file to compute digest", filename));
+                       boost::throw_exception (FileError("could not read file to compute digest", filename, r));
                }
-               
+
                SHA1_Update (&sha, read_buffer.Data(), read);
 
                if (progress) {
-                       (*progress) (float (done) / size);
+                       progress(done, size);
                        done += read;
                }
        }
 
-       byte_t byte_buffer[20];
+       byte_t byte_buffer[SHA_DIGEST_LENGTH];
        SHA1_Final (byte_buffer, &sha);
 
        char digest[64];
-       return Kumu::base64encode (byte_buffer, 20, digest, 64);
+       return Kumu::base64encode (byte_buffer, SHA_DIGEST_LENGTH, digest, 64);
 }
 
-/** Convert a content kind to a string which can be used in a
- *  <ContentKind> node.
- *  @param kind ContentKind.
- *  @return string.
- */
-string
-libdcp::content_kind_to_string (ContentKind kind)
+
+void
+dcp::init (optional<boost::filesystem::path> given_resources_directory)
 {
-       switch (kind) {
-       case FEATURE:
-               return "feature";
-       case SHORT:
-               return "short";
-       case TRAILER:
-               return "trailer";
-       case TEST:
-               return "test";
-       case TRANSITIONAL:
-               return "transitional";
-       case RATING:
-               return "rating";
-       case TEASER:
-               return "teaser";
-       case POLICY:
-               return "policy";
-       case PUBLIC_SERVICE_ANNOUNCEMENT:
-               return "psa";
-       case ADVERTISEMENT:
-               return "advertisement";
+       if (xmlSecInit() < 0) {
+               throw MiscError ("could not initialise xmlsec");
+       }
+
+#ifdef XMLSEC_CRYPTO_DYNAMIC_LOADING
+       if (xmlSecCryptoDLLoadLibrary(BAD_CAST "openssl") < 0) {
+               throw MiscError ("unable to load openssl xmlsec-crypto library");
+       }
+#endif
+
+       if (xmlSecCryptoAppInit(0) < 0) {
+               throw MiscError ("could not initialise crypto");
+       }
+
+       if (xmlSecCryptoInit() < 0) {
+               throw MiscError ("could not initialise xmlsec-crypto");
        }
 
-       assert (false);
+       OpenSSL_add_all_algorithms();
+
+       asdcp_smpte_dict = &ASDCP::DefaultSMPTEDict();
+
+       auto res = given_resources_directory.get_value_or(resources_directory());
+
+       load_language_tag_lists (res / "tags");
+       load_rating_list (res / "ratings");
 }
 
-/** Convert a string from a <ContentKind> node to a libdcp ContentKind.
- *  Reasonably tolerant about varying case.
- *  @param type Content kind string.
- *  @return libdcp ContentKind.
- */
-libdcp::ContentKind
-libdcp::content_kind_from_string (string type)
+
+int
+dcp::base64_decode (string const & in, unsigned char* out, int out_length)
 {
-       /* XXX: should probably just convert type to lower-case and have done with it */
-       
-       if (type == "feature") {
-               return FEATURE;
-       } else if (type == "short") {
-               return SHORT;
-       } else if (type == "trailer" || type == "Trailer") {
-               return TRAILER;
-       } else if (type == "test") {
-               return TEST;
-       } else if (type == "transitional") {
-               return TRANSITIONAL;
-       } else if (type == "rating") {
-               return RATING;
-       } else if (type == "teaser" || type == "Teaser") {
-               return TEASER;
-       } else if (type == "policy") {
-               return POLICY;
-       } else if (type == "psa") {
-               return PUBLIC_SERVICE_ANNOUNCEMENT;
-       } else if (type == "advertisement") {
-               return ADVERTISEMENT;
+       auto b64 = BIO_new (BIO_f_base64());
+
+       /* This means the input should have no newlines */
+       BIO_set_flags (b64, BIO_FLAGS_BASE64_NO_NL);
+
+       /* Copy our input string, removing newlines */
+       char in_buffer[in.size() + 1];
+       char* p = in_buffer;
+       for (size_t i = 0; i < in.size(); ++i) {
+               if (in[i] != '\n' && in[i] != '\r') {
+                       *p++ = in[i];
+               }
        }
 
-       assert (false);
+       auto bmem = BIO_new_mem_buf (in_buffer, p - in_buffer);
+       bmem = BIO_push (b64, bmem);
+       int const N = BIO_read (bmem, out, out_length);
+       BIO_free_all (bmem);
+
+       return N;
 }
 
-/** Decompress a JPEG2000 image to a bitmap.
- *  @param data JPEG2000 data.
- *  @param size Size of data in bytes.
- *  @param reduce A power of 2 by which to reduce the size of the decoded image;
- *  e.g. 0 reduces by (2^0 == 1), ie keeping the same size.
- *       1 reduces by (2^1 == 2), ie halving the size of the image.
- *  This is useful for scaling 4K DCP images down to 2K.
- *  @return XYZ image.
- */
-shared_ptr<libdcp::XYZFrame>
-libdcp::decompress_j2k (uint8_t* data, int64_t size, int reduce)
+
+optional<boost::filesystem::path>
+dcp::relative_to_root (boost::filesystem::path root, boost::filesystem::path file)
 {
-       opj_dinfo_t* decoder = opj_create_decompress (CODEC_J2K);
-       opj_dparameters_t parameters;
-       opj_set_default_decoder_parameters (&parameters);
-       parameters.cp_reduce = reduce;
-       opj_setup_decoder (decoder, &parameters);
-       opj_cio_t* cio = opj_cio_open ((opj_common_ptr) decoder, data, size);
-       opj_image_t* image = opj_decode (decoder, cio);
-       if (!image) {
-               opj_destroy_decompress (decoder);
-               opj_cio_close (cio);
-               boost::throw_exception (DCPReadError ("could not decode JPEG2000 codestream of " + lexical_cast<string> (size) + " bytes."));
+       auto i = root.begin ();
+       auto j = file.begin ();
+
+       while (i != root.end() && j != file.end() && *i == *j) {
+               ++i;
+               ++j;
+       }
+
+       if (i != root.end()) {
+               return {};
        }
 
-       opj_cio_close (cio);
+       boost::filesystem::path rel;
+       while (j != file.end()) {
+               rel /= *j++;
+       }
 
-       image->x1 = rint (float(image->x1) / pow (2, reduce));
-       image->y1 = rint (float(image->y1) / pow (2, reduce));
-       return shared_ptr<XYZFrame> (new XYZFrame (image));
+       return rel;
 }
 
-/** @param s A string.
- *  @return true if the string contains only space, newline or tab characters, or is empty.
- */
+
 bool
-libdcp::empty_or_white_space (string s)
+dcp::ids_equal (string a, string b)
 {
-       for (size_t i = 0; i < s.length(); ++i) {
-               if (s[i] != ' ' && s[i] != '\n' && s[i] != '\t') {
-                       return false;
-               }
+       transform (a.begin(), a.end(), a.begin(), ::tolower);
+       transform (b.begin(), b.end(), b.begin(), ::tolower);
+       trim (a);
+       trim (b);
+       return a == b;
+}
+
+
+string
+dcp::file_to_string (boost::filesystem::path p, uintmax_t max_length)
+{
+       auto len = filesystem::file_size(p);
+       if (len > max_length) {
+               throw MiscError (String::compose("Unexpectedly long file (%1)", p.string()));
+       }
+
+       File f(p, "r");
+       if (!f) {
+               throw FileError ("could not open file", p, errno);
        }
 
-       return true;
+       std::vector<char> buffer(len);
+       /* This may read less than `len' if we are on Windows and we have CRLF in the file */
+       int const N = f.read(buffer.data(), 1, len);
+       return string(buffer.data(), N);
 }
 
+
 void
-libdcp::init ()
+dcp::write_string_to_file(string const& string, boost::filesystem::path const& path)
 {
-       if (xmlSecInit() < 0) {
-               throw MiscError ("could not initialise xmlsec");
+       File file(path, "w");
+       if (!file) {
+               throw FileError("could not open file", path, errno);
        }
 
-#ifdef XMLSEC_CRYPTO_DYNAMIC_LOADING
-       if (xmlSecCryptoDLLoadLibrary(BAD_CAST XMLSEC_CRYPTO) < 0) {
-               throw MiscError ("unable to load default xmlsec-crypto library");
-       }
-#endif 
+       file.write(string.c_str(), string.length(), 1);
+}
 
-       if (xmlSecCryptoAppInit(0) < 0) {
-               throw MiscError ("could not initialise crypto");
-       }
 
-       if (xmlSecCryptoInit() < 0) {
-               throw MiscError ("could not initialise xmlsec-crypto");
-       }
+string
+dcp::private_key_fingerprint (string key)
+{
+       boost::replace_all (key, "-----BEGIN RSA PRIVATE KEY-----\n", "");
+       boost::replace_all (key, "\n-----END RSA PRIVATE KEY-----\n", "");
+       boost::replace_all (key, "-----BEGIN PRIVATE KEY-----\n", "");
+       boost::replace_all (key, "\n-----END PRIVATE KEY-----\n", "");
+
+       unsigned char buffer[4096];
+       int const N = base64_decode (key, buffer, sizeof (buffer));
+
+       SHA_CTX sha;
+       SHA1_Init (&sha);
+       SHA1_Update (&sha, buffer, N);
+       uint8_t digest[20];
+       SHA1_Final (digest, &sha);
+
+       char digest_base64[64];
+       return Kumu::base64encode (digest, 20, digest_base64, 64);
 }
 
-/** Sign an XML node.  This function takes a certificate chain (to prove that the sender is bona fide) and
- *  a private key with which to sign the node.
- *
- *  @param parent Node to sign.
- *  @param certificates Certificate chain for the signer.
- *  @param signer_key Filename of the private key of the signer.
- *  @param ns Namespace to use for the signature XML nodes.
- */
-void
-libdcp::add_signature_value (xmlpp::Element* parent, CertificateChain const & certificates, boost::filesystem::path signer_key, string const & ns)
+
+xmlpp::Node *
+dcp::find_child (xmlpp::Node const * node, string name)
 {
-       parent->add_child("SignatureValue", ns);
-
-       /* Add the certificate chain to a KeyInfo child node of parent */
-       xmlpp::Element* key_info = parent->add_child("KeyInfo", ns);
-       list<shared_ptr<Certificate> > c = certificates.leaf_to_root ();
-       for (list<shared_ptr<Certificate> >::iterator i = c.begin(); i != c.end(); ++i) {
-               xmlpp::Element* data = key_info->add_child("X509Data", ns);
-               
-               {
-                       xmlpp::Element* serial = data->add_child("X509IssuerSerial", ns);
-                       serial->add_child("X509IssuerName", ns)->add_child_text((*i)->issuer ());
-                       serial->add_child("X509SerialNumber", ns)->add_child_text((*i)->serial ());
-               }
-               
-               data->add_child("X509Certificate", ns)->add_child_text((*i)->certificate());
+       auto c = node->get_children ();
+       auto i = c.begin();
+       while (i != c.end() && (*i)->get_name() != name) {
+               ++i;
        }
 
-       xmlSecDSigCtxPtr signature_context = xmlSecDSigCtxCreate (0);
-       if (signature_context == 0) {
-               throw MiscError ("could not create signature context");
-       }
+       DCP_ASSERT (i != c.end ());
+       return *i;
+}
 
-       signature_context->signKey = xmlSecCryptoAppKeyLoad (signer_key.c_str(), xmlSecKeyDataFormatPem, 0, 0, 0);
-       if (signature_context->signKey == 0) {
-               throw FileError ("could not load private key file", signer_key);
-       }
 
-       /* XXX: set key name to the file name: is this right? */
-       if (xmlSecKeySetName (signature_context->signKey, reinterpret_cast<const xmlChar *> (signer_key.c_str())) < 0) {
-               throw MiscError ("could not set key name");
+string
+dcp::remove_urn_uuid (string raw)
+{
+       if (raw.substr(0, 9) != "urn:uuid:") {
+               throw BadURNUUIDError(raw);
        }
 
-       if (xmlSecDSigCtxSign (signature_context, parent->cobj ()) < 0) {
-               throw MiscError ("could not sign");
-       }
+       return raw.substr (9);
+}
+
 
-       xmlSecDSigCtxDestroy (signature_context);
+string
+dcp::openjpeg_version ()
+{
+       return opj_version ();
 }
 
 
-void
-libdcp::add_signer (xmlpp::Element* parent, CertificateChain const & certificates, string const & ns)
+string
+dcp::spaces (int n)
 {
-       xmlpp::Element* signer = parent->add_child("Signer");
-
-       {
-               xmlpp::Element* data = signer->add_child("X509Data", ns);
-               
-               {
-                       xmlpp::Element* serial_element = data->add_child("X509IssuerSerial", ns);
-                       serial_element->add_child("X509IssuerName", ns)->add_child_text (certificates.leaf()->issuer());
-                       serial_element->add_child("X509SerialNumber", ns)->add_child_text (certificates.leaf()->serial());
-               }
-               
-               data->add_child("X509SubjectName", ns)->add_child_text (certificates.leaf()->subject());
+       string s = "";
+       for (int i = 0; i < n; ++i) {
+               s += " ";
        }
+       return s;
 }
 
-/** @param signer_key Filename of private key to sign with */
+
 void
-libdcp::sign (xmlpp::Element* parent, CertificateChain const & certificates, boost::filesystem::path signer_key, bool interop)
+dcp::indent (xmlpp::Element* element, int initial)
 {
-       add_signer (parent, certificates, "dsig");
-
-       xmlpp::Element* signature = parent->add_child("Signature", "dsig");
-       
-       {
-               xmlpp::Element* signed_info = signature->add_child ("SignedInfo", "dsig");
-               signed_info->add_child("CanonicalizationMethod", "dsig")->set_attribute ("Algorithm", "http://www.w3.org/TR/2001/REC-xml-c14n-20010315");
-
-               if (interop) {
-                       signed_info->add_child("SignatureMethod", "dsig")->set_attribute("Algorithm", "http://www.w3.org/2000/09/xmldsig#rsa-sha1");
-               } else {
-                       signed_info->add_child("SignatureMethod", "dsig")->set_attribute("Algorithm", "http://www.w3.org/2001/04/xmldsig-more#rsa-sha256");
-               }
-               
-               {
-                       xmlpp::Element* reference = signed_info->add_child("Reference", "dsig");
-                       reference->set_attribute ("URI", "");
-                       {
-                               xmlpp::Element* transforms = reference->add_child("Transforms", "dsig");
-                               transforms->add_child("Transform", "dsig")->set_attribute (
-                                       "Algorithm", "http://www.w3.org/2000/09/xmldsig#enveloped-signature"
-                                       );
-                       }
-                       reference->add_child("DigestMethod", "dsig")->set_attribute("Algorithm", "http://www.w3.org/2000/09/xmldsig#sha1");
-                       /* This will be filled in by the signing later */
-                       reference->add_child("DigestValue", "dsig");
+       xmlpp::Node* last = nullptr;
+       for (auto n: element->get_children()) {
+               auto e = dynamic_cast<xmlpp::Element*>(n);
+               if (e) {
+                       element->add_child_text_before (e, "\n" + spaces(initial + 2));
+                       indent (e, initial + 2);
+                       last = n;
                }
        }
-       
-       add_signature_value (signature, certificates, signer_key, "dsig");
+       if (last) {
+               element->add_child_text (last, "\n" + spaces(initial));
+       }
 }
 
-bool libdcp::operator== (libdcp::Size const & a, libdcp::Size const & b)
-{
-       return (a.width == b.width && a.height == b.height);
-}
 
-bool libdcp::operator!= (libdcp::Size const & a, libdcp::Size const & b)
+bool
+dcp::day_less_than_or_equal (LocalTime a, LocalTime b)
 {
-       return !(a == b);
+       if (a.year() != b.year()) {
+               return a.year() < b.year();
+       }
+
+       if (a.month() != b.month()) {
+               return a.month() < b.month();
+       }
+
+       return a.day() <= b.day();
 }
 
-/** The base64 decode routine in KM_util.cpp gives different values to both
- *  this and the command-line base64 for some inputs.  Not sure why.
- */
-int
-libdcp::base64_decode (string const & in, unsigned char* out, int out_length)
+
+bool
+dcp::day_greater_than_or_equal (LocalTime a, LocalTime b)
 {
-       BIO* b64 = BIO_new (BIO_f_base64 ());
+       if (a.year() != b.year()) {
+               return a.year() > b.year();
+       }
 
-       /* This means the input should have no newlines */
-       BIO_set_flags (b64, BIO_FLAGS_BASE64_NO_NL);
+       if (a.month() != b.month()) {
+               return a.month() > b.month();
+       }
 
-       /* Copy our input string, removing newlines */
-       char in_buffer[in.size() + 1];
-       char* p = in_buffer;
-       for (size_t i = 0; i < in.size(); ++i) {
-               if (in[i] != '\n' && in[i] != '\r') {
-                       *p++ = in[i];
+       return a.day() >= b.day();
+}
+
+
+string
+dcp::unique_string (vector<string> existing, string base)
+{
+       int const max_tries = existing.size() + 1;
+       for (int i = 0; i < max_tries; ++i) {
+               string trial = String::compose("%1%2", base, i);
+               if (find(existing.begin(), existing.end(), trial) == existing.end()) {
+                       return trial;
                }
        }
-               
-       BIO* bmem = BIO_new_mem_buf (in_buffer, p - in_buffer);
-       bmem = BIO_push (b64, bmem);
-       int const N = BIO_read (bmem, out, out_length);
-       BIO_free_all (bmem);
 
-       return N;
+       DCP_ASSERT (false);
 }
 
-string
-libdcp::tm_to_string (struct tm* tm)
+
+ASDCPErrorSuspender::ASDCPErrorSuspender ()
+       : _old (Kumu::DefaultLogSink())
 {
-       char buffer[64];
-       strftime (buffer, 64, "%Y-%m-%dT%I:%M:%S", tm);
+       _sink = new Kumu::EntryListLogSink(_log);
+       Kumu::SetDefaultLogSink (_sink);
+}
 
-       int offset = 0;
 
-#ifdef LIBDCP_POSIX
-       offset = tm->tm_gmtoff / 60;
-#else
-       TIME_ZONE_INFORMATION tz;
-       GetTimeZoneInformation (&tz);
-       offset = tz.Bias;
-#endif
-       
-       return string (buffer) + utc_offset_to_string (offset);
+ASDCPErrorSuspender::~ASDCPErrorSuspender ()
+{
+       Kumu::SetDefaultLogSink (&_old);
+       delete _sink;
 }
 
-/** @param b Offset from UTC to local time in minutes.
- *  @return string of the form e.g. -01:00.
- */
-string
-libdcp::utc_offset_to_string (int b)
+
+boost::filesystem::path dcp::directory_containing_executable ()
 {
-       bool const negative = (b < 0);
-       b = negative ? -b : b;
+#if BOOST_VERSION >= 106100
+       return filesystem::canonical(boost::dll::program_location().parent_path());
+#else
+       char buffer[PATH_MAX];
+       ssize_t N = readlink ("/proc/self/exe", buffer, PATH_MAX);
+       return boost::filesystem::path(string(buffer, N)).parent_path();
+#endif
+}
 
-       int const hours = b / 60;
-       int const minutes = b % 60;
 
-       stringstream o;
-       if (negative) {
-               o << "-";
-       } else {
-               o << "+";
+boost::filesystem::path dcp::resources_directory ()
+{
+       /* We need a way to specify the tags directory for running un-installed binaries */
+       char* prefix = getenv("LIBDCP_RESOURCES");
+       if (prefix) {
+               return prefix;
        }
 
-       o << setw(2) << setfill('0') << hours << ":" << setw(2) << setfill('0') << minutes;
-       return o.str ();
+#if defined(LIBDCP_OSX)
+       return directory_containing_executable().parent_path() / "Resources";
+#elif defined(LIBDCP_WINDOWS)
+       return directory_containing_executable().parent_path();
+#else
+       return directory_containing_executable().parent_path() / "share" / "libdcp";
+#endif
 }
 
-string
-libdcp::ptime_to_string (boost::posix_time::ptime t)
-{
-       struct tm t_tm = boost::posix_time::to_tm (t);
-       return tm_to_string (&t_tm);
-}
+