merge (w/fix) with master
[ardour.git] / libs / ardour / file_source.cc
index caddc12b5bdd8b6c3b1f4c7c3f402ca1be8d13cb..e06b3d624ef09adadc3b7f3131be8074d9fbe4bf 100644 (file)
 
 #include "pbd/convert.h"
 #include "pbd/basename.h"
-#include "pbd/mountpoint.h"
 #include "pbd/stl_delete.h"
 #include "pbd/strsplit.h"
 #include "pbd/shortpath.h"
 #include "pbd/enumwriter.h"
+#include "pbd/file_utils.h"
 
 #include <glibmm/miscutils.h>
 #include <glibmm/fileutils.h>
-#include <glibmm/thread.h>
+#include <glibmm/threads.h>
 
+#include "ardour/data_type.h"
 #include "ardour/file_source.h"
 #include "ardour/session.h"
-#include "ardour/session_directory.h"
-#include "ardour/source_factory.h"
-#include "ardour/filename_extensions.h"
+#include "ardour/source.h"
+#include "ardour/utils.h"
 
 #include "i18n.h"
 
@@ -51,21 +51,23 @@ using namespace ARDOUR;
 using namespace PBD;
 using namespace Glib;
 
-static const std::string PATH_SEP = "/"; // I don't do windows
+PBD::Signal2<int,std::string,std::vector<std::string> > FileSource::AmbiguousFileName;
 
-map<DataType, ustring> FileSource::search_paths;
-
-FileSource::FileSource (Session& session, DataType type, const ustring& path, Source::Flag flag)
+FileSource::FileSource (Session& session, DataType type, const string& path, const string& origin, Source::Flag flag)
        : Source(session, type, path, flag)
-       , _path(path)
-       , _file_is_new(true)
+       , _path (path)
+       , _file_is_new (!origin.empty()) // origin empty => new file VS. origin !empty => new file
        , _channel (0)
+        , _origin (origin)
+        , _open (false)
 {
        set_within_session_from_path (path);
+
+        prevent_deletion ();
 }
 
 FileSource::FileSource (Session& session, const XMLNode& node, bool /*must_exist*/)
-       : Source(session, node)
+       : Source (session, node)
        , _file_is_new (false)
 {
        /* this setting of _path is temporary - we expect derived classes
@@ -75,33 +77,58 @@ FileSource::FileSource (Session& session, const XMLNode& node, bool /*must_exist
 
        _path = _name;
        _within_session = true;
+
+        prevent_deletion ();
+}
+
+void
+FileSource::prevent_deletion ()
+{
+        /* if this file already exists, it cannot be removed, ever
+         */
+
+        if (Glib::file_test (_path, Glib::FILE_TEST_EXISTS)) {
+                if (!(_flags & Destructive)) {
+                        mark_immutable ();
+                } else {
+                        _flags = Flag (_flags & ~(Removable|RemovableIfEmpty|RemoveAtDestroy));
+                }
+        }
 }
 
 bool
 FileSource::removable () const
 {
-       return (_flags & Removable)
-               && ((_flags & RemoveAtDestroy) || 
-                   ((_flags & RemovableIfEmpty) && length(timeline_position()) == 0));
+        bool r = ((_flags & Removable)
+                  && ((_flags & RemoveAtDestroy) ||
+                      ((_flags & RemovableIfEmpty) && empty() == 0)));
+
+        return r;
 }
 
 int
-FileSource::init (const ustring& pathstr, bool must_exist)
+FileSource::init (const string& pathstr, bool must_exist)
 {
        _timeline_position = 0;
 
-       if (!find (_type, pathstr, must_exist, _file_is_new, _channel, _path)) {
-               throw MissingSource ();
+       if (Stateful::loading_state_version < 3000) {
+               if (!find_2X (_session, _type, pathstr, must_exist, _file_is_new, _channel, _path)) {
+                       throw MissingSource (pathstr, _type);
+               }
+       } else {
+               if (!find (_session, _type, pathstr, must_exist, _file_is_new, _channel, _path)) {
+                       throw MissingSource (pathstr, _type);
+               }
        }
 
-       set_within_session_from_path (pathstr);
+       set_within_session_from_path (_path);
 
-       if (_within_session) {
-               _name = Glib::path_get_basename (_name);
-       }
+        _name = Glib::path_get_basename (_path);
 
-       if (_file_is_new && must_exist) {
-               return -1;
+       if (must_exist) {
+               if (!Glib::file_test (_path, Glib::FILE_TEST_EXISTS)) {
+                       throw MissingSource (pathstr, _type);
+               }
        }
 
        return 0;
@@ -118,11 +145,15 @@ FileSource::set_state (const XMLNode& node, int /*version*/)
                _channel = 0;
        }
 
+        if ((prop = node.property (X_("origin"))) != 0) {
+                _origin = prop->value();
+        }
+
        return 0;
 }
 
 void
-FileSource::mark_take (const ustring& id)
+FileSource::mark_take (const string& id)
 {
        if (writable ()) {
                _take_id = id;
@@ -130,7 +161,7 @@ FileSource::mark_take (const ustring& id)
 }
 
 int
-FileSource::move_to_trash (const ustring& trash_dir_name)
+FileSource::move_to_trash (const string& trash_dir_name)
 {
        if (!within_session() || !writable()) {
                return -1;
@@ -140,23 +171,24 @@ FileSource::move_to_trash (const ustring& trash_dir_name)
           trash_dir_name directory on whichever filesystem it was already on
        */
 
-       ustring newpath;
-       newpath = Glib::path_get_dirname (_path);
-       newpath = Glib::path_get_dirname (newpath);
+        vector<string> v;
+       v.push_back (Glib::path_get_dirname (Glib::path_get_dirname (_path)));
+        v.push_back (trash_dir_name);
+       v.push_back (Glib::path_get_basename (_path));
 
-       newpath += string(PATH_SEP) + trash_dir_name + PATH_SEP;
-       newpath += Glib::path_get_basename (_path);
+       string newpath = Glib::build_filename (v);
 
        /* the new path already exists, try versioning */
-       if (access (newpath.c_str(), F_OK) == 0) {
+
+       if (Glib::file_test (newpath.c_str(), Glib::FILE_TEST_EXISTS)) {
                char buf[PATH_MAX+1];
                int version = 1;
-               ustring newpath_v;
+               string newpath_v;
 
                snprintf (buf, sizeof (buf), "%s.%d", newpath.c_str(), version);
                newpath_v = buf;
 
-               while (access (newpath_v.c_str(), F_OK) == 0 && version < 999) {
+               while (Glib::file_test (newpath_v, Glib::FILE_TEST_EXISTS) && version < 999) {
                        snprintf (buf, sizeof (buf), "%s.%d", newpath.c_str(), ++version);
                        newpath_v = buf;
                }
@@ -199,48 +231,159 @@ FileSource::move_to_trash (const ustring& trash_dir_name)
  * \return true iff the file was found.
  */
 bool
-FileSource::find (DataType type, const ustring& path, bool must_exist,
-                 bool& isnew, uint16_t& chan, ustring& found_path)
+FileSource::find (Session& s, DataType type, const string& path, bool must_exist,
+                 bool& isnew, uint16_t& /* chan */, string& found_path)
 {
-       Glib::ustring search_path = search_paths[type];
+       bool ret = false;
+        string keeppath;
+
+       isnew = false;
+
+        if (!Glib::path_is_absolute (path)) {
+                vector<string> hits;
+                string fullpath;
+               std::vector<std::string> dirs = s.source_search_path (type);
+
+                if (dirs.size() == 0) {
+                        error << _("FileSource: search path not set") << endmsg;
+                        goto out;
+                }
+
+                hits.clear ();
+
+                for (vector<string>::iterator i = dirs.begin(); i != dirs.end(); ++i) {
+
+                        fullpath = Glib::build_filename (*i, path);
+
+                        if (Glib::file_test (fullpath, Glib::FILE_TEST_EXISTS|Glib::FILE_TEST_IS_REGULAR)) {
+                                keeppath = fullpath;
+                                hits.push_back (fullpath);
+                        }
+                }
+
+               /* Remove duplicate inodes from the list of ambiguous files, since if there are symlinks
+                  in the session path it is possible to arrive at the same file via more than one path.
+
+                  I suppose this is not necessary on Windows.
+               */
+
+               vector<string> de_duped_hits;
+
+               for (vector<string>::iterator i = hits.begin(); i != hits.end(); ++i) {
+
+                       vector<string>::iterator j = i;
+                       ++j;
+                       
+                       while (j != hits.end()) {
+                               if (PBD::equivalent_paths (*i, *j)) {
+                                       /* *i and *j are the same file; break out of the loop early */
+                                       break;
+                               }
+
+                               ++j;
+                       }
+
+                       if (j == hits.end ()) {
+                               de_duped_hits.push_back (*i);
+                       }
+               }
+
+                if (de_duped_hits.size() > 1) {
+
+                       /* more than one match: ask the user */
+
+                        int which = FileSource::AmbiguousFileName (path, de_duped_hits).get_value_or (-1);
+
+                        if (which < 0) {
+                                goto out;
+                        } else {
+                                keeppath = de_duped_hits[which];
+                        }
+
+                } else if (de_duped_hits.size() == 0) {
+
+                       /* no match: error */
+
+                        if (must_exist) {
+                                error << string_compose(
+                                        _("Filesource: cannot find required file (%1)"), path) << endmsg;
+                                goto out;
+                        } else {
+                                isnew = true;
+                        }
+                } else {
 
-       ustring pathstr = path;
-       ustring::size_type pos;
+                       /* only one match: happy days */
+                       
+                       keeppath = de_duped_hits[0];
+               }
+                                                 
+        } else {
+                keeppath = path;
+        }
+
+        /* Current find() is unable to parse relative path names to yet non-existant
+           sources. QuickFix(tm)
+        */
+        if (keeppath == "") {
+                if (must_exist) {
+                        error << "FileSource::find(), keeppath = \"\", but the file must exist" << endl;
+                } else {
+                        keeppath = path;
+                }
+        }
+
+        found_path = keeppath;
+
+        ret = true;
+
+  out:
+       return ret;
+}
+
+/** Find the actual source file based on \a filename.
+ *
+ * If the source is within the session tree, \a filename should be a simple filename (no slashes).
+ * If the source is external, \a filename should be a full path.
+ * In either case, found_path is set to the complete absolute path of the source file.
+ * \return true iff the file was found.
+ */
+bool
+FileSource::find_2X (Session& s, DataType type, const string& path, bool must_exist,
+                     bool& isnew, uint16_t& chan, string& found_path)
+{
+       string pathstr = path;
+       string::size_type pos;
        bool ret = false;
 
        isnew = false;
 
-       if (pathstr[0] != '/') {
+       if (!Glib::path_is_absolute (pathstr)) {
 
                /* non-absolute pathname: find pathstr in search path */
 
-               vector<ustring> dirs;
+               vector<string> dirs = s.source_search_path (type);
+
                int cnt;
-               ustring fullpath;
-               ustring keeppath;
+               string fullpath;
+               string keeppath;
 
-               if (search_path.length() == 0) {
+               if (dirs.size() == 0) {
                        error << _("FileSource: search path not set") << endmsg;
                        goto out;
                }
 
-               split (search_path, dirs, ':');
-
                cnt = 0;
 
-               for (vector<ustring>::iterator i = dirs.begin(); i != dirs.end(); ++i) {
-                       fullpath = *i;
-                       if (fullpath[fullpath.length()-1] != '/') {
-                               fullpath += '/';
-                       }
+               for (vector<string>::iterator i = dirs.begin(); i != dirs.end(); ++i) {
 
-                       fullpath += pathstr;
+                        fullpath = Glib::build_filename (*i, pathstr);
 
                        /* i (paul) made a nasty design error by using ':' as a special character in
                           Ardour 0.99 .. this hack tries to make things sort of work.
                        */
 
-                       if ((pos = pathstr.find_last_of (':')) != ustring::npos) {
+                       if ((pos = pathstr.find_last_of (':')) != string::npos) {
 
                                if (Glib::file_test (fullpath, Glib::FILE_TEST_EXISTS|Glib::FILE_TEST_IS_REGULAR)) {
 
@@ -257,14 +400,8 @@ FileSource::find (DataType type, const ustring& path, bool must_exist,
                                                   without the :suffix exists
                                                 */
 
-                                               ustring shorter = pathstr.substr (0, pos);
-                                               fullpath = *i;
-
-                                               if (fullpath[fullpath.length()-1] != '/') {
-                                                       fullpath += '/';
-                                               }
-
-                                               fullpath += shorter;
+                                               string shorter = pathstr.substr (0, pos);
+                                                fullpath = Glib::build_filename (*i, shorter);
 
                                                if (Glib::file_test (pathstr, Glib::FILE_TEST_EXISTS|Glib::FILE_TEST_IS_REGULAR)) {
                                                        chan = atoi (pathstr.substr (pos+1));
@@ -292,16 +429,15 @@ FileSource::find (DataType type, const ustring& path, bool must_exist,
                if (cnt > 1) {
 
                        error << string_compose (
-                                       _("FileSource: \"%1\" is ambigous when searching %2\n\t"),
-                                       pathstr, search_path) << endmsg;
+                                       _("FileSource: \"%1\" is ambigous when searching\n\t"), pathstr) << endmsg;
                        goto out;
 
                } else if (cnt == 0) {
 
                        if (must_exist) {
                                error << string_compose(
-                                               _("Filesource: cannot find required file (%1): while searching %2"),
-                                               pathstr, search_path) << endmsg;
+                                               _("Filesource: cannot find required file (%1): while searching")
+                                               , pathstr) << endmsg;
                                goto out;
                        } else {
                                isnew = true;
@@ -328,9 +464,9 @@ FileSource::find (DataType type, const ustring& path, bool must_exist,
 
                /* ugh, handle ':' situation */
 
-               if ((pos = pathstr.find_last_of (':')) != ustring::npos) {
+               if ((pos = pathstr.find_last_of (':')) != string::npos) {
 
-                       ustring shorter = pathstr.substr (0, pos);
+                       string shorter = pathstr.substr (0, pos);
 
                        if (Glib::file_test (shorter, Glib::FILE_TEST_EXISTS|Glib::FILE_TEST_IS_REGULAR)) {
                                chan = atoi (pathstr.substr (pos+1));
@@ -351,13 +487,14 @@ FileSource::find (DataType type, const ustring& path, bool must_exist,
                                goto out;
                        }
 
+#ifndef PLATFORM_WINDOWS
                        if (errno != ENOENT) {
                                error << string_compose(
                                                _("Filesource: cannot check for existing file (%1): %2"),
                                                path, strerror (errno)) << endmsg;
                                goto out;
                        }
-
+#endif
                        /* a new file */
                        isnew = true;
                        ret = true;
@@ -374,11 +511,11 @@ out:
 }
 
 int
-FileSource::set_source_name (const ustring& newname, bool destructive)
+FileSource::set_source_name (const string& newname, bool destructive)
 {
-       Glib::Mutex::Lock lm (_lock);
-       ustring oldpath = _path;
-       ustring newpath = Session::change_source_path_by_name (oldpath, _name, newname, destructive);
+       Glib::Threads::Mutex::Lock lm (_lock);
+       string oldpath = _path;
+       string newpath = _session.change_source_path_by_name (oldpath, _name, newname, destructive);
 
        if (newpath.empty()) {
                error << string_compose (_("programming error: %1"), "cannot generate a changed file path") << endmsg;
@@ -386,15 +523,15 @@ FileSource::set_source_name (const ustring& newname, bool destructive)
        }
 
        // Test whether newpath exists, if yes notify the user but continue.
-       if (access(newpath.c_str(),F_OK) == 0) {
-               error << _("Programming error! Ardour tried to rename a file over another file! It's safe to continue working, but please report this to the developers.") << endmsg;
+       if (Glib::file_test (newpath, Glib::FILE_TEST_EXISTS)) {
+               error << string_compose (_("Programming error! %1 tried to rename a file over another file! It's safe to continue working, but please report this to the developers."), PROGRAM_NAME) << endmsg;
                return -1;
        }
 
-       if (rename (oldpath.c_str(), newpath.c_str()) != 0) {
-               error << string_compose (_("cannot rename audio file %1 to %2"), _name, newpath) << endmsg;
-               return -1;
-       }
+        if (::rename (oldpath.c_str(), newpath.c_str()) != 0) {
+                error << string_compose (_("cannot rename file %1 to %2 (%3)"), oldpath, newpath, strerror(errno)) << endmsg;
+                return -1;
+        }
 
        _name = Glib::path_get_basename (newpath);
        _path = newpath;
@@ -403,22 +540,44 @@ FileSource::set_source_name (const ustring& newname, bool destructive)
 }
 
 void
-FileSource::set_search_path (DataType type, const ustring& p)
+FileSource::mark_immutable ()
 {
-       search_paths[type] = p;
+       /* destructive sources stay writable, and their other flags don't change.  */
+       if (!(_flags & Destructive)) {
+               _flags = Flag (_flags & ~(Writable|Removable|RemovableIfEmpty|RemoveAtDestroy|CanRename));
+       }
 }
 
 void
-FileSource::mark_immutable ()
+FileSource::mark_immutable_except_write ()
 {
        /* destructive sources stay writable, and their other flags don't change.  */
        if (!(_flags & Destructive)) {
-               _flags = Flag (_flags & ~(Writable|Removable|RemovableIfEmpty|RemoveAtDestroy|CanRename));
+               _flags = Flag (_flags & ~(Removable|RemovableIfEmpty|RemoveAtDestroy|CanRename));
        }
 }
 
+void
+FileSource::mark_nonremovable ()
+{
+        _flags = Flag (_flags & ~(Removable|RemovableIfEmpty|RemoveAtDestroy));
+}
+
 void
 FileSource::set_within_session_from_path (const std::string& path)
 {
        _within_session = _session.path_is_within_session (path);
 }
+
+void
+FileSource::set_path (const std::string& newpath)
+{
+        _path = newpath;
+}
+
+void
+FileSource::inc_use_count ()
+{
+        Source::inc_use_count ();
+}
+