Important changes to repositories hosted on mbed.com
Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.
To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.
It is also possible to export all your personal repositories from the account settings page.
FileSystemHandle.h
00001 /* mbed Microcontroller Library 00002 * Copyright (c) 2006-2013 ARM Limited 00003 * 00004 * Licensed under the Apache License, Version 2.0 (the "License"); 00005 * you may not use this file except in compliance with the License. 00006 * You may obtain a copy of the License at 00007 * 00008 * http://www.apache.org/licenses/LICENSE-2.0 00009 * 00010 * Unless required by applicable law or agreed to in writing, software 00011 * distributed under the License is distributed on an "AS IS" BASIS, 00012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 00013 * See the License for the specific language governing permissions and 00014 * limitations under the License. 00015 */ 00016 #ifndef MBED_FILESYSTEMHANDLE_H 00017 #define MBED_FILESYSTEMHANDLE_H 00018 00019 #include "platform/platform.h" 00020 00021 #include "platform/FileBase.h" 00022 #include "platform/FileHandle.h" 00023 #include "platform/DirHandle.h" 00024 #include "platform/NonCopyable.h" 00025 00026 namespace mbed { 00027 /** \addtogroup platform */ 00028 /** @{*/ 00029 /** 00030 * \defgroup platform_FileSystemHandle FileSystemHandle functions 00031 * @{ 00032 */ 00033 00034 00035 /** A filesystem-like object is one that can be used to open file-like 00036 * objects though it by fopen("/name/filename", mode) 00037 * 00038 * Implementations must define at least open (the default definitions 00039 * of the rest of the functions just return error values). 00040 * 00041 * @note Synchronization level: Set by subclass 00042 */ 00043 class FileSystemHandle : private NonCopyable<FileSystemHandle> { 00044 public: 00045 /** FileSystemHandle lifetime 00046 */ 00047 virtual ~FileSystemHandle() {} 00048 00049 /** Open a file on the filesystem 00050 * 00051 * @param file Destination for the handle to a newly created file 00052 * @param filename The name of the file to open 00053 * @param flags The flags to open the file in, one of O_RDONLY, O_WRONLY, O_RDWR, 00054 * bitwise or'd with one of O_CREAT, O_TRUNC, O_APPEND 00055 * @return 0 on success, negative error code on failure 00056 */ 00057 virtual int open(FileHandle **file, const char *filename, int flags) = 0; 00058 00059 /** Open a directory on the filesystem 00060 * 00061 * @param dir Destination for the handle to the directory 00062 * @param path Name of the directory to open 00063 * @return 0 on success, negative error code on failure 00064 */ 00065 virtual int open(DirHandle **dir, const char *path); 00066 00067 /** Remove a file from the filesystem. 00068 * 00069 * @param path The name of the file to remove. 00070 * @return 0 on success, negative error code on failure 00071 */ 00072 virtual int remove(const char *path); 00073 00074 /** Rename a file in the filesystem. 00075 * 00076 * @param path The name of the file to rename. 00077 * @param newpath The name to rename it to 00078 * @return 0 on success, negative error code on failure 00079 */ 00080 virtual int rename(const char *path, const char *newpath); 00081 00082 /** Store information about the file in a stat structure 00083 * 00084 * @param path The name of the file to find information about 00085 * @param st The stat buffer to write to 00086 * @return 0 on success, negative error code on failure 00087 */ 00088 virtual int stat(const char *path, struct stat *st); 00089 00090 /** Create a directory in the filesystem. 00091 * 00092 * @param path The name of the directory to create. 00093 * @param mode The permissions with which to create the directory 00094 * @return 0 on success, negative error code on failure 00095 */ 00096 virtual int mkdir(const char *path, mode_t mode); 00097 00098 /** Store information about the mounted filesystem in a statvfs structure 00099 * 00100 * @param path The name of the file to find information about 00101 * @param buf The stat buffer to write to 00102 * @return 0 on success, negative error code on failure 00103 */ 00104 virtual int statvfs(const char *path, struct statvfs *buf); 00105 }; 00106 /**@}*/ 00107 00108 /**@}*/ 00109 00110 } // namespace mbed 00111 00112 #endif 00113 00114 /** @}*/
Generated on Tue Jul 12 2022 12:44:06 by
