Difference between revisions of "Libntfs"
m (→Credits) |
m |
||
| Line 1: | Line 1: | ||
| + | {{lowercase title}} | ||
{{Infobox development tools | {{Infobox development tools | ||
| title = libntfs | | title = libntfs | ||
| Line 11: | Line 12: | ||
| source = http://github.com/rhyskoedijk/libntfs/tree/master | | source = http://github.com/rhyskoedijk/libntfs/tree/master | ||
}} | }} | ||
| − | + | '''''libntfs''''' is a port of the [http://www.ntfs-3g.org/ NTFS-3G] driver to the Nintendo GameCube/Wii, modelled on the [[libFAT]] interface. | |
| − | '''libntfs''' is a port of the [http://www.ntfs-3g.org/ NTFS-3G] driver to the Nintendo GameCube/Wii, modelled on the [[libFAT]] interface. | ||
[http://www.ntfs-3g.org/ NTFS-3G] is an open source cross-platform implementation of the Microsoft Windows NTFS file system. | [http://www.ntfs-3g.org/ NTFS-3G] is an open source cross-platform implementation of the Microsoft Windows NTFS file system. | ||
==Features== | ==Features== | ||
| − | |||
* Full read/write, files of any size can be created, modified, renamed, moved, or deleted. | * Full read/write, files of any size can be created, modified, renamed, moved, or deleted. | ||
* Compression, read/write support for compressed files | * Compression, read/write support for compressed files | ||
| Line 26: | Line 25: | ||
===Unsupported=== | ===Unsupported=== | ||
| − | |||
* Encryption, read/write support for encrypted files | * Encryption, read/write support for encrypted files | ||
* Security (will probably never be implemented, criples library functionality) | * Security (will probably never be implemented, criples library functionality) | ||
==Implementation Specific Features== | ==Implementation Specific Features== | ||
| − | |||
The following describes some of the differences between '''libntfs''' and other implementations of [http://www.ntfs-3g.org/ NTFS-3G]. | The following describes some of the differences between '''libntfs''' and other implementations of [http://www.ntfs-3g.org/ NTFS-3G]. | ||
| Line 46: | Line 43: | ||
==Compiling and Installing== | ==Compiling and Installing== | ||
| − | |||
Make sure you have [[devKitPPC]] and the latest [[libogc]] installed. Then from the sources root directory, type: | Make sure you have [[devKitPPC]] and the latest [[libogc]] installed. Then from the sources root directory, type: | ||
| Line 53: | Line 49: | ||
==Usage== | ==Usage== | ||
| − | |||
NTFS related routines can be accessed by adding the following line to your source file(s). | NTFS related routines can be accessed by adding the following line to your source file(s). | ||
| Line 65: | Line 60: | ||
==Credits== | ==Credits== | ||
| − | |||
A big thanks to all the authors of [http://www.ntfs-3g.org/ NTFS-3G], of which this library makes use of. Thanks also to the following: | A big thanks to all the authors of [http://www.ntfs-3g.org/ NTFS-3G], of which this library makes use of. Thanks also to the following: | ||
| Line 73: | Line 67: | ||
==Update History== | ==Update History== | ||
| − | |||
===August 19, 2009=== | ===August 19, 2009=== | ||
* Inital release, based on NTFS-3G 2009.4.4AR.16 | * Inital release, based on NTFS-3G 2009.4.4AR.16 | ||
Revision as of 01:29, 18 October 2009
| libntfs | |
 | |
| General | |
|---|---|
| Author(s) | Numerous |
| Maintainer(s) | shareese |
| Contributor(s) | rodries |
| Type | Ported Libraries |
| Version | August 19, 2009 |
| Licence | GNU GPL v2 |
| Links | |
| Source | |
libntfs is a port of the NTFS-3G driver to the Nintendo GameCube/Wii, modelled on the libFAT interface.
NTFS-3G is an open source cross-platform implementation of the Microsoft Windows NTFS file system.
Features
- Full read/write, files of any size can be created, modified, renamed, moved, or deleted.
- Compression, read/write support for compressed files
- Symbolic link and directory junction walking
- Partial journaling (see below)
NTFS-3G only supports partial journaling, so unexpected crashes or power loss can leave the file system in an inconsistent state. The only way to (correctly) fix it is to boot into Windows and let NTFS replay the journal; However, in most suitations (read: it is not 100% guaranteed) this is not required and the file system can be remounted without problem. In suitations where there has been heavy disc activity prior to the crash or power loss it is recommended you let Windows replay the journal before remounting with libntfs in order to prevent possible data lose and/or corruption.
Unsupported
- Encryption, read/write support for encrypted files
- Security (will probably never be implemented, criples library functionality)
Implementation Specific Features
The following describes some of the differences between libntfs and other implementations of NTFS-3G.
Symbolic Links
Symbolics links are supported by the NTFS filesystem and are therefore supported in libntfs; however, whenever libntfs encounters a symbolic link it will (transparently) resolve it first. The effect of this is that when you open a symbolic link you in instaid open what it is linked to. Creation of symbolic links is still supported, however once created you cannot actually tell it apart from a standard hard link due to the transparent symbloic link resolution.
This was a design choice and not a defect. I may change this behaviour in the future if it turns out to be troublesome.
Getting the latest sources
To grab the latest and greatest copy of the sources just type:
git clone http://github.com/rhyskoedijk/libntfs/tree/master
Compiling and Installing
Make sure you have devKitPPC and the latest libogc installed. Then from the sources root directory, type:
make make install # or 'sudo make install' if you aren't root.
Usage
NTFS related routines can be accessed by adding the following line to your source file(s).
#include <ntfs.h>
When compiling you must also link against libntfs. To do this, add -lntfs to the LIBS section of your application Makefile; for example:
LIBS := -lwiiuse -lbte -lntfs -lfat -logc -lm
For a more practical example of using NTFS in your application, see the included 'example' folder.
Credits
A big thanks to all the authors of NTFS-3G, of which this library makes use of. Thanks also to the following:
- Authors of libogc for providing the libraries framework
- Authors of libFAT for laying the foundations
- rodries for his help and contributions (cache, bug fixes, etc)
Update History
August 19, 2009
- Inital release, based on NTFS-3G 2009.4.4AR.16