summaryrefslogtreecommitdiff
path: root/include/user/kernel/iofilemgr.h
diff options
context:
space:
mode:
authorReiko Asakura2020-07-21 15:10:11 -0400
committerReiko Asakura2020-07-21 15:10:11 -0400
commit16f304f919c7a23e615ca1c045fc98a53ae01824 (patch)
tree9716d989df32a044d8fad807eaf669b06946a025 /include/user/kernel/iofilemgr.h
parentAdd doc and remove unneeded include (diff)
downloadvds-libraries-16f304f919c7a23e615ca1c045fc98a53ae01824.tar.gz
Refactor userland SceIofilemgr headers
Diffstat (limited to 'include/user/kernel/iofilemgr.h')
-rw-r--r--include/user/kernel/iofilemgr.h295
1 files changed, 295 insertions, 0 deletions
diff --git a/include/user/kernel/iofilemgr.h b/include/user/kernel/iofilemgr.h
new file mode 100644
index 0000000..33f79d0
--- /dev/null
+++ b/include/user/kernel/iofilemgr.h
@@ -0,0 +1,295 @@
+#ifndef _DOLCESDK_PSP2_KERNEL_IOFILEMGR_H_
+#define _DOLCESDK_PSP2_KERNEL_IOFILEMGR_H_
+
+#include <psp2/kernel/types.h>
+#include <psp2/kernel/iofilemgr/stat.h>
+#include <psp2/kernel/iofilemgr/dirent.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* device types */
+#define SCE_D_TYPE_NULL 0x0 /* dummy device */
+#define SCE_D_TYPE_CHAR 0x1 /* character device */
+#define SCE_D_TYPE_BLOCK 0x4 /* block device */
+#define SCE_D_TYPE_FS 0x10 /* file system */
+#define SCE_D_TYPE_ALIAS 0x20 /* alias name (device alias) */
+#define SCE_D_TYPE_MOUNTPT 0x40 /* alias name (mount point) */
+
+/* flags */
+#define SCE_FREAD (0x0001) /* readable */
+#define SCE_FWRITE (0x0002) /* writable */
+#define SCE_FNBLOCK (0x0004) /* Reserved: non-blocking reads */
+#define SCE_FDIRO (0x0008) /* internal use for dopen */
+#define SCE_FRLOCK (0x0010) /* Reserved: read locked (non-shared) */
+#define SCE_FWLOCK (0x0020) /* Reserved: write locked (non-shared) */
+#define SCE_FAPPEND (0x0100) /* append on each write */
+#define SCE_FCREAT (0x0200) /* create if nonexistant */
+#define SCE_FTRUNC (0x0400) /* truncate to zero length */
+#define SCE_EXCL (0x0800) /* exclusive create */
+#define SCE_FSCAN (0x1000) /* Reserved: scan type */
+#define SCE_FRCOM (0x2000) /* Reserved: remote command entry */
+#define SCE_FNBUF (0x4000) /* no device buffer */
+#define SCE_FASYNC (0x8000) /* Reserved: asyncronous i/o */
+#define SCE_FFDEXCL (0x01000000) /* exclusive access */
+#define SCE_FGAMEDATA (0x40000000)
+
+/* Flag for sceIoOpen() */
+#define SCE_O_RDONLY (SCE_FREAD)
+#define SCE_O_WRONLY (SCE_FWRITE)
+#define SCE_O_RDWR (SCE_FREAD|SCE_FWRITE)
+#define SCE_O_NBLOCK (SCE_FNBLOCK) /* Reserved: Non-Blocking I/O */
+#define SCE_O_APPEND (SCE_FAPPEND) /* append (writes guaranteed at the end) */
+#define SCE_O_CREAT (SCE_FCREAT) /* open with file create */
+#define SCE_O_TRUNC (SCE_FTRUNC) /* open with truncation */
+#define SCE_O_EXCL (SCE_EXCL) /* exclusive create */
+#define SCE_O_NOBUF (SCE_FNBUF) /* no device buffer */
+#define SCE_O_NOWAIT (SCE_FASYNC) /* Reserved: asyncronous i/o */
+#define SCE_O_FDEXCL (SCE_FFDEXCL) /* exclusive access */
+#define SCE_O_PWLOCK (SCE_FPWLOCK) /* power control lock */
+#define SCE_O_FGAMEDATA (SCE_FGAMEDATA)
+
+/* Flag for sceIoLseek() */
+#define SCE_SEEK_SET (0)
+#define SCE_SEEK_CUR (1)
+#define SCE_SEEK_END (2)
+
+/* Path */
+#define SCE_IO_MAX_PATH_BUFFER_SIZE (1024) /* maximum path buffer size */
+#define SCE_IO_MAX_PATH_LENGTH (200) /* maximum path length */
+
+/**
+ * Remove directory entry
+ *
+ * @param filename - Path to the file to remove
+ * @return < 0 on error
+ */
+int sceIoRemove(const char *filename);
+
+/**
+ * Make a directory file
+ *
+ * @param dirname - The path to the directory
+ * @param mode - Access mode bits.
+ * @return Returns the value 0 if it's successful, otherwise <0
+ */
+int sceIoMkdir(const char *dirname, SceIoMode mode);
+
+/**
+ * Remove a directory file
+ *
+ * @param dirname - Removes a directory file pointed by the string path
+ * @return Returns the value 0 if it's successful, otherwise <0
+ */
+int sceIoRmdir(const char *dirname);
+
+/**
+ * Change the name of a file
+ *
+ * @param oldname - The old filename
+ * @param newname - The new filename
+ * @return < 0 on error.
+ */
+int sceIoRename(const char *oldname, const char *newname);
+
+/**
+ * Send a devctl command to a device.
+ *
+ * @par Example: Sending a simple command to a device
+ * @code
+ * SceIoDevInfo info;
+ * sceIoDevctl("ux0:", 0x3001, NULL, 0, &info, sizeof(SceIoDevInfo));
+ * @endcode
+ *
+ * @param devname - String for the device to send the devctl to (e.g. "ux0:")
+ * @param cmd - The command to send to the device
+ * @param arg - A data block to send to the device, if NULL sends no data
+ * @param arglen - Length of indata, if 0 sends no data
+ * @param bufp - A data block to receive the result of a command, if NULL receives no data
+ * @param buflen - Length of outdata, if 0 receives no data
+ * @return 0 on success, < 0 on error
+ */
+int sceIoDevctl(
+ const char *devname,
+ int cmd,
+ const void *arg,
+ SceSize arglen,
+ void *bufp,
+ SceSize buflen);
+
+/**
+ * Synchronize the file data on the device.
+ *
+ * @param devname - The device to synchronize (e.g. msfat0:)
+ * @param flag - device specific flags
+ */
+int sceIoSync(const char *devname, int flag);
+
+/**
+ * Open or create a file for reading or writing
+ *
+ * @par Example1: Open a file for reading
+ * @code
+ * if((fd = sceIoOpen("device:/path/to/file", SCE_O_RDONLY, 0777) < 0) {
+ * // error code in fd, for example no open filehandle left (0x80010018)
+ * }
+ * @endcode
+ * @par Example2: Open a file for writing, creating it if it doesn't exist
+ * @code
+ * if((fd = sceIoOpen("device:/path/to/file", SCE_O_WRONLY|SCE_O_CREAT, 0777) < 0) {
+ * // error code in fd, for example no open filehandle left (0x80010018)
+ * }
+ * @endcode
+ *
+ * @param filename - Pointer to a string holding the name of the file to open
+ * @param flag - Libc styled flags that are or'ed together
+ * @param mode - File access mode (One or more ::SceIoMode).
+ * @return A non-negative integer is a valid fd, anything else an error
+ */
+SceUID sceIoOpen(const char *filename, int flag, SceIoMode mode);
+
+/**
+ * Delete a descriptor
+ *
+ * @code
+ * sceIoClose(fd);
+ * @endcode
+ *
+ * @param fd - File descriptor to close
+ * @return < 0 on error
+ */
+int sceIoClose(SceUID fd);
+
+/**
+ * Perform an ioctl on a device.
+ *
+ * @param fd - Opened file descriptor to ioctl to
+ * @param cmd - The command to send to the device
+ * @param argp - A data block to send to the device, if NULL sends no data
+ * @param arglen - Length of indata, if 0 sends no data
+ * @param bufp - A data block to receive the result of a command, if NULL receives no data
+ * @param buflen - Length of outdata, if 0 receives no data
+ * @return 0 on success, < 0 on error
+ */
+int sceIoIoctl(
+ SceUID fd,
+ int cmd,
+ const void *argp,
+ SceSize arglen,
+ void *bufp,
+ SceSize buflen);
+
+/**
+ * Reposition read/write file descriptor offset
+ *
+ * @par Example:
+ * @code
+ * pos = sceIoLseek(fd, -10, SCE_SEEK_END);
+ * @endcode
+ *
+ * @param fd - Opened file descriptor with which to seek
+ * @param offset - Relative offset from the start position given by whence
+ * @param whence - One of ::SceIoSeekMode.
+ *
+ * @return The position in the file after the seek.
+ */
+SceOff sceIoLseek(SceUID fd, SceOff offset, int whence);
+
+/**
+ * Reposition read/write file descriptor offset (32bit mode)
+ *
+ * @par Example:
+ * @code
+ * pos = sceIoLseek32(fd, -10, SCE_SEEK_END);
+ * @endcode
+ *
+ * @param fd - Opened file descriptor with which to seek
+ * @param offset - Relative offset from the start position given by whence
+ * @param whence - One of ::SceIoSeekMode.
+ *
+ * @return The position in the file after the seek.
+ */
+long sceIoLseek32(SceUID fd, long offset, int whence);
+
+/**
+ * Read input
+ *
+ * @par Example:
+ * @code
+ * bytes_read = sceIoRead(fd, data, 100);
+ * @endcode
+ *
+ * @param fd - Opened file descriptor to read from
+ * @param buf - Pointer to the buffer where the read data will be placed
+ * @param nbyte - Size of the read in bytes
+ *
+ * @return The number of bytes read
+ */
+SceSSize sceIoRead(SceUID fd, void *buf, SceSize nbyte);
+
+/**
+ * Write output
+ *
+ * @par Example:
+ * @code
+ * bytes_written = sceIoWrite(fd, data, 100);
+ * @endcode
+ *
+ * @param fd - Opened file descriptor to write to
+ * @param buf - Pointer to the data to write
+ * @param nbyte - Size of data to write
+ *
+ * @return The number of bytes written
+ */
+SceSSize sceIoWrite(SceUID fd, const void *buf, SceSize nbyte);
+
+/**
+ * Read input at offset
+ *
+ * @par Example:
+ * @code
+ * bytes_read = sceIoPread(fd, data, 100, 0x1000);
+ * @endcode
+ *
+ * @param fd - Opened file descriptor to read from
+ * @param buf - Pointer to the buffer where the read data will be placed
+ * @param nbyte - Size of the read in bytes
+ * @param offset - Offset to read
+ *
+ * @return < 0 on error.
+ */
+SceSSize sceIoPread(SceUID fd, void *buf, SceSize nbyte, SceOff offset);
+
+/**
+ * Write output at offset
+ *
+ * @par Example:
+ * @code
+ * bytes_written = sceIoPwrite(fd, data, 100, 0x1000);
+ * @endcode
+ *
+ * @param fd - Opened file descriptor to write to
+ * @param buf - Pointer to the data to write
+ * @param nbyte - Size of data to write
+ * @param offset - Offset to write
+ *
+ * @return The number of bytes written
+ */
+SceSSize sceIoPwrite(SceUID fd, const void *buf, SceSize nbyte, SceOff offset);
+
+/**
+ * Synchronize the file data for one file
+ *
+ * @param fd - Opened file descriptor to sync
+ * @param flag - device specific flags
+ *
+ * @return < 0 on error.
+ */
+int sceIoSyncByFd(SceUID fd, int flag);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* _DOLCESDK_PSP2_KERNEL_IOFILEMGR_H_ */