149 lines
6.3 KiB
C
149 lines
6.3 KiB
C
/**
|
|
* ntfs.h - Simple functionality for startup, mounting and unmounting of NTFS-based devices.
|
|
*
|
|
* Copyright (c) 2010 Dimok
|
|
* Copyright (c) 2009 Rhys "Shareese" Koedijk
|
|
* Copyright (c) 2006 Michael "Chishm" Chisholm
|
|
*
|
|
* This program/include file is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU General Public License as published
|
|
* by the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program/include file 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 General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software Foundation,
|
|
* Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
*/
|
|
|
|
#ifndef _LIBNTFS_H
|
|
#define _LIBNTFS_H
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#include <gctypes.h>
|
|
#include <gccore.h>
|
|
#include <ogc/disc_io.h>
|
|
|
|
/* NTFS errno values */
|
|
#define ENOPART 3000 /* No partition was found */
|
|
#define EINVALPART 3001 /* Specified partition is invalid or not supported */
|
|
#define EDIRTY 3002 /* Volume is dirty and NTFS_RECOVER was not specified during mount */
|
|
#define EHIBERNATED 3003 /* Volume is hibernated and NTFS_IGNORE_HIBERFILE was not specified during mount */
|
|
|
|
/* NTFS cache options */
|
|
#define CACHE_DEFAULT_PAGE_COUNT 8 /* The default number of pages in the cache */
|
|
#define CACHE_DEFAULT_PAGE_SIZE 128 /* The default number of sectors per cache page */
|
|
|
|
/* NTFS mount flags */
|
|
#define NTFS_DEFAULT 0x00000000 /* Standard mount, expects a clean, non-hibernated volume */
|
|
#define NTFS_SHOW_HIDDEN_FILES 0x00000001 /* Display hidden files when enumerating directories */
|
|
#define NTFS_SHOW_SYSTEM_FILES 0x00000002 /* Display system files when enumerating directories */
|
|
#define NTFS_UPDATE_ACCESS_TIMES 0x00000004 /* Update file and directory access times */
|
|
#define NTFS_RECOVER 0x00000008 /* Reset $LogFile if dirty (i.e. from unclean disconnect) */
|
|
#define NTFS_IGNORE_HIBERFILE 0x00000010 /* Mount even if volume is hibernated */
|
|
#define NTFS_READ_ONLY 0x00000020 /* Mount in read only mode */
|
|
#define NTFS_IGNORE_CASE 0x00000040 /* Ignore case sensitivity. Everything must be and will be provided in lowercase. */
|
|
#define NTFS_SU NTFS_SHOW_HIDDEN_FILES | NTFS_SHOW_SYSTEM_FILES
|
|
#define NTFS_FORCE NTFS_RECOVER | NTFS_IGNORE_HIBERFILE
|
|
|
|
/**
|
|
* ntfs_md - NTFS mount descriptor
|
|
*/
|
|
typedef struct _ntfs_md {
|
|
char name[32]; /* Mount name (can be accessed as "name:/") */
|
|
const DISC_INTERFACE *interface; /* Block device containing the mounted partition */
|
|
sec_t startSector; /* Local block address to first sector of partition */
|
|
} ntfs_md;
|
|
|
|
/**
|
|
* Find all NTFS partitions on a block device.
|
|
*
|
|
* @param INTERFACE The block device to search
|
|
* @param PARTITIONS (out) A pointer to receive the array of partition start sectors
|
|
*
|
|
* @return The number of entries in PARTITIONS or -1 if an error occurred (see errno)
|
|
* @note The caller is responsible for freeing PARTITIONS when finished with it
|
|
*/
|
|
extern int ntfsFindPartitions (const DISC_INTERFACE *interface, sec_t **partitions);
|
|
|
|
/**
|
|
* Mount all NTFS partitions on all inserted block devices.
|
|
*
|
|
* @param MOUNTS (out) A pointer to receive the array of mount descriptors
|
|
* @param FLAGS Additional mounting flags. (see above)
|
|
*
|
|
* @return The number of entries in MOUNTS or -1 if an error occurred (see errno)
|
|
* @note The caller is responsible for freeing MOUNTS when finished with it
|
|
* @note All device caches are setup using default values (see above)
|
|
*/
|
|
extern int ntfsMountAll (ntfs_md **mounts, u32 flags);
|
|
|
|
/**
|
|
* Mount all NTFS partitions on a block devices.
|
|
*
|
|
* @param INTERFACE The block device to mount.
|
|
* @param MOUNTS (out) A pointer to receive the array of mount descriptors
|
|
* @param FLAGS Additional mounting flags. (see above)
|
|
*
|
|
* @return The number of entries in MOUNTS or -1 if an error occurred (see errno)
|
|
* @note The caller is responsible for freeing MOUNTS when finished with it
|
|
* @note The device cache is setup using default values (see above)
|
|
*/
|
|
extern int ntfsMountDevice (const DISC_INTERFACE* interface, ntfs_md **mounts, u32 flags);
|
|
|
|
/**
|
|
* Mount a NTFS partition from a specific sector on a block device.
|
|
*
|
|
* @param NAME The name to mount the device under (can then be accessed as "NAME:/")
|
|
* @param INTERFACE The block device to mount
|
|
* @param STARTSECTOR The sector the partition begins at (see @ntfsFindPartitions)
|
|
* @param CACHEPAGECOUNT The total number of pages in the device cache
|
|
* @param CACHEPAGESIZE The number of sectors per cache page
|
|
* @param FLAGS Additional mounting flags (see above)
|
|
*
|
|
* @return True if mount was successful, false if no partition was found or an error occurred (see errno)
|
|
* @note ntfsFindPartitions should be used first to locate the partitions start sector
|
|
*/
|
|
extern bool ntfsMount (const char *name, const DISC_INTERFACE *interface, sec_t startSector, u32 cachePageCount, u32 cachePageSize, u32 flags);
|
|
|
|
/**
|
|
* Unmount a NTFS partition.
|
|
*
|
|
* @param NAME The name of mount used in ntfsMountSimple() and ntfsMount()
|
|
* @param FORCE If true unmount even if the device is busy (may lead to data lose)
|
|
*/
|
|
extern void ntfsUnmount (const char *name, bool force);
|
|
|
|
/**
|
|
* Get the volume name of a mounted NTFS partition.
|
|
*
|
|
* @param NAME The name of mount (see @ntfsMountAll, @ntfsMountDevice, and @ntfsMount)
|
|
*
|
|
* @return The volumes name if successful or NULL if an error occurred (see errno)
|
|
*/
|
|
extern const char *ntfsGetVolumeName (const char *name);
|
|
|
|
/**
|
|
* Set the volume name of a mounted NTFS partition.
|
|
*
|
|
* @param NAME The name of mount (see @ntfsMountAll, @ntfsMountDevice, and @ntfsMount)
|
|
* @param VOLUMENAME The new volume name
|
|
*
|
|
* @return True if mount was successful, false if an error occurred (see errno)
|
|
* @note The mount must be write-enabled else this will fail
|
|
*/
|
|
extern bool ntfsSetVolumeName (const char *name, const char *volumeName);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* _LIBNTFS_H */
|