1 files changed, 99 insertions, 0 deletions
diff --git a/desktop/source/app/lockfile.hxx b/desktop/source/app/lockfile.hxx
new file mode 100644
index 000000000000..248e44c52160
--- /dev/null
+++ b/desktop/source/app/lockfile.hxx
@@ -0,0 +1,99 @@
+/*************************************************************************
+ *
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * Copyright 2000, 2010 Oracle and/or its affiliates.
+ *
+ * OpenOffice.org - a multi-platform office productivity suite
+ *
+ * This file is part of OpenOffice.org.
+ *
+ * OpenOffice.org is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License version 3
+ * only, as published by the Free Software Foundation.
+ *
+ * OpenOffice.org 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 Lesser General Public License version 3 for more details
+ * (a copy is included in the LICENSE file that accompanied this code).
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * version 3 along with OpenOffice.org.  If not, see
+ * <http://www.openoffice.org/license.html>
+ * for a copy of the LGPLv3 License.
+ *
+ ************************************************************************/
+
+/* Information:
+ * This class implements a mechanism to lock a users installation directory,
+ * which is necessesary because instances of staroffice could be running on
+ * different hosts while using the same directory thus causing data
+ * inconsistency.
+ * When an existing lock is detected, the user will be asked whether he wants
+ * to continue anyway, thus removing the lock and replacing it with a new one
+ *
+ * ideas:
+ * - store information about user and host and time in the lockfile and display
+ * these when asking whether to remove the lockfile.
+ * - periodically check the lockfile and warn the user when it gets replaced
+ *
+ */
+
+#include "sal/types.h"
+#include "rtl/ustring.hxx"
+
+class ByteString;
+
+namespace desktop {
+
+    class Lockfile;
+    bool Lockfile_execWarning( Lockfile * that );
+
+    class Lockfile
+    {
+    public:
+
+        // contructs a new lockfile onject
+        Lockfile( bool bIPCserver = true );
+
+        // separating GUI code:
+        typedef bool (* fpExecWarning)( Lockfile * that );
+
+        // checks the lockfile, asks user when lockfile is
+        // found (iff gui) and returns false when we may not continue
+        sal_Bool check( fpExecWarning execWarning );
+
+        // removes the lockfile. should only be called in exceptional situations
+        void clean(void);
+
+        // removes the lockfile
+        ~Lockfile(void);
+
+    private:
+        // data in lockfile
+        static const ByteString Group();
+        static const ByteString Userkey();
+        static const ByteString Hostkey();
+        static const ByteString Stampkey();
+        static const ByteString Timekey();
+        static const ByteString IPCkey();
+        // lockfilename
+        static const rtl::OUString Suffix();
+        bool m_bIPCserver;
+        // full qualified name (file://-url) of the lockfile
+        rtl::OUString m_aLockname;
+        // flag whether the d'tor should delete the lock
+        sal_Bool m_bRemove;
+        sal_Bool m_bIsLocked;
+        // ID
+        rtl::OUString m_aId;
+        rtl::OUString m_aDate;
+        // access to data in file
+        void syncToFile(void) const;
+        sal_Bool isStale(void) const;
+        friend bool Lockfile_execWarning( Lockfile * that );
+
+    };
+
+}