Changeset 105087 in vbox for trunk/src/VBox/Main/include

Timestamp:

Jul 1, 2024 11:27:59 PM (7 months ago)

Author:

vboxsync

Message:

doc/manual,include/VBox,Frontends/VBoxManage,HostServices/SharedFolders,
Main/{include,SharedFolder,Console,Machine,VirtualBox.xidl}: Add a
new attribute to ISharedFolder for specifying a symbolic link creation
policy to restrict the source pathname when creating symbolic links
within a guest. The symbolic link policies are represented by a new
enumeration of type SymlinkPolicy_T which includes values for no
restrictions ('any'), symlink sources only within the subtree of the
share ('subtree'), symlink sources as any relative path ('relative'),
and no symlinks allowed ('forbidden'). The symlink policy can only be
applied to permanent shared folders at this stage. bugref:10619

Location:

trunk/src/VBox/Main/include

Files:

• ConsoleSharedFolderImpl.h (modified) (3 diffs)
• MachineImpl.h (modified) (1 diff)
• SharedFolderImpl.h (modified) (4 diffs)

trunk/src/VBox/Main/include/ConsoleSharedFolderImpl.h

@@ -89 +89 @@
     const Utf8Str &i_getAutoMountPoint() const;
 
+    /**
+     * Public internal method for getting the symlink policy.
+     */
+    const SymlinkPolicy_T i_getSymlinkPolicy() const;
+
 protected:
 
@@ -100 +105 @@
 private:
 
-    // wrapped ISharedFolder properies.
+    // wrapped ISharedFolder properties.
     HRESULT getName(com::Utf8Str &aName);
     HRESULT getHostPath(com::Utf8Str &aHostPath);
@@ -111 +116 @@
     HRESULT setAutoMountPoint(com::Utf8Str const &aAutoMountPoint);
     HRESULT getLastAccessError(com::Utf8Str &aLastAccessError);
+    HRESULT getSymlinkPolicy(SymlinkPolicy_T *aSymlinkPolicy);
+    HRESULT setSymlinkPolicy(SymlinkPolicy_T aSymlinkPolicy);
 
     VirtualBoxBase * const mParent;

trunk/src/VBox/Main/include/MachineImpl.h

@@ -911 +911 @@
     friend class RecordingScreenSettings;
     friend class SessionMachine;
+    friend class SharedFolder;
     friend class SnapshotMachine;
     friend class VirtualBox;

trunk/src/VBox/Main/include/SharedFolderImpl.h

@@ -49 +49 @@
     // public initializer/uninitializer for internal purposes only
     HRESULT init(Machine *aMachine, const com::Utf8Str &aName, const com::Utf8Str &aHostPath,
-                 bool aWritable, bool aAutoMount, const com::Utf8Str &aAutoMountPoint, bool fFailOnError);
+                 bool aWritable, bool aAutoMount, const com::Utf8Str &aAutoMountPoint, bool fFailOnError,
+                 SymlinkPolicy_T enmSymlinkPolicy);
     HRESULT initCopy(Machine *aMachine, SharedFolder *aThat);
 //    HRESULT init(Console *aConsole, const com::Utf8Str &aName, const com::Utf8Str &aHostPath,
@@ -89 +90 @@
     const Utf8Str &i_getAutoMountPoint() const;
 
+    /**
+     * Public internal method for getting the symlink policy.
+     */
+    const SymlinkPolicy_T i_getSymlinkPolicy() const;
+
 protected:
 
@@ -97 +103 @@
                             bool aAutoMount,
                             const com::Utf8Str &aAutoMountPoint,
-                            bool fFailOnError);
+                            bool fFailOnError,
+                            SymlinkPolicy_T enmSymlinkPolicy);
 private:
 
-    // wrapped ISharedFolder properies.
+    // wrapped ISharedFolder properties.
     HRESULT getName(com::Utf8Str &aName);
     HRESULT getHostPath(com::Utf8Str &aHostPath);
@@ -111 +118 @@
     HRESULT setAutoMountPoint(com::Utf8Str const &aAutoMountPoint);
     HRESULT getLastAccessError(com::Utf8Str &aLastAccessError);
+    HRESULT getSymlinkPolicy(SymlinkPolicy_T *aSymlinkPolicy);
+    HRESULT setSymlinkPolicy(SymlinkPolicy_T aSymlinkPolicy);
 
     VirtualBoxBase * const mParent;