aboutsummaryrefslogtreecommitdiffstats
path: root/lib/public/Files/Mount/IMountPoint.php
diff options
context:
space:
mode:
Diffstat (limited to 'lib/public/Files/Mount/IMountPoint.php')
-rw-r--r--lib/public/Files/Mount/IMountPoint.php122
1 files changed, 122 insertions, 0 deletions
diff --git a/lib/public/Files/Mount/IMountPoint.php b/lib/public/Files/Mount/IMountPoint.php
new file mode 100644
index 00000000000..8989a885fda
--- /dev/null
+++ b/lib/public/Files/Mount/IMountPoint.php
@@ -0,0 +1,122 @@
+<?php
+
+/**
+ * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-FileCopyrightText: 2016 ownCloud, Inc.
+ * SPDX-License-Identifier: AGPL-3.0-only
+ */
+namespace OCP\Files\Mount;
+
+/**
+ * A storage mounted to folder on the filesystem
+ * @since 8.0.0
+ */
+interface IMountPoint {
+ /**
+ * get complete path to the mount point
+ *
+ * @return string
+ * @since 8.0.0
+ */
+ public function getMountPoint();
+
+ /**
+ * Set the mountpoint
+ *
+ * @param string $mountPoint new mount point
+ * @since 8.0.0
+ */
+ public function setMountPoint($mountPoint);
+
+ /**
+ * Get the storage that is mounted
+ *
+ * @return \OCP\Files\Storage\IStorage|null
+ * @since 8.0.0
+ */
+ public function getStorage();
+
+ /**
+ * Get the id of the storages
+ *
+ * @return string|null
+ * @since 8.0.0
+ */
+ public function getStorageId();
+
+ /**
+ * Get the id of the storages
+ *
+ * @return int|null
+ * @since 9.1.0
+ */
+ public function getNumericStorageId();
+
+ /**
+ * Get the path relative to the mountpoint
+ *
+ * @param string $path absolute path to a file or folder
+ * @return string
+ * @since 8.0.0
+ */
+ public function getInternalPath($path);
+
+ /**
+ * Apply a storage wrapper to the mounted storage
+ *
+ * @param callable $wrapper
+ * @since 8.0.0
+ */
+ public function wrapStorage($wrapper);
+
+ /**
+ * Get a mount option
+ *
+ * @param string $name Name of the mount option to get
+ * @param mixed $default Default value for the mount option
+ * @return mixed
+ * @since 8.0.0
+ */
+ public function getOption($name, $default);
+
+ /**
+ * Get all options for the mount
+ *
+ * @return array
+ * @since 8.1.0
+ */
+ public function getOptions();
+
+ /**
+ * Get the file id of the root of the storage
+ *
+ * @return int
+ * @since 9.1.0
+ */
+ public function getStorageRootId();
+
+ /**
+ * Get the id of the configured mount
+ *
+ * @return int|null mount id or null if not applicable
+ * @since 9.1.0
+ */
+ public function getMountId();
+
+ /**
+ * Get the type of mount point, used to distinguish things like shares and external storage
+ * in the web interface
+ *
+ * @return string
+ * @since 12.0.0
+ */
+ public function getMountType();
+
+ /**
+ * Get the class of the mount provider that this mount originates from
+ *
+ * @return string
+ * @since 24.0.0
+ */
+ public function getMountProvider(): string;
+}