Difference between revisions of "Libdolfs"
Jump to navigation
Jump to search
(←Created page with '{{lowercase title}} '''libdolfs''' is a library for accessing a read-only ramdisk (attached to a .dol at compile-time) as though it were a regular filesystem. It provides a c...') |
|||
| (7 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
{{lowercase title}} | {{lowercase title}} | ||
| − | '''libdolfs''' is a library for accessing a read-only ramdisk (attached to a .dol at compile-time) as though it were a regular filesystem. It provides a convenient way to include support data with an executable, esp. when porting some code where you don't want to change the underlying core to add an alternative to fread()... or when using psoload without an SD card. | + | {{Infobox development tools |
| + | | title = libdolfs | ||
| + | | description = Read-only .dol-attached Ramdisk | ||
| + | | type = library | ||
| + | | author = [[User:Hornpipe2|Hornpipe2]] | ||
| + | | version = (initial) | ||
| + | | download = http://www.tehskeen.com/forums/showthread.php?t=14277 | ||
| + | | source = http://www.tehskeen.com/forums/showthread.php?t=14277 | ||
| + | | website = http://www.tehskeen.com/forums/showthread.php?t=14277 | ||
| + | }} | ||
| + | {{No Download}} | ||
| + | '''''libdolfs''''' is a library for accessing a read-only ramdisk (attached to a .dol at compile-time) as though it were a regular filesystem. It provides a convenient way to include support data with an executable, esp. when porting some code where you don't want to change the underlying core to add an alternative to fread()... or when using psoload without an SD card. | ||
| − | + | This initial release does not support directory access, but does allow long filenames. | |
| − | |||
This software is in the public domain. | This software is in the public domain. | ||
| − | + | == Usage and Sample Code == | |
| − | + | It's a lot like using bin2o to add binary data to the executable, but this library uses the Newlib devoptab structs to let you then access the data like any attached filesystem using fopen(), fread(), etc. | |
| − | |||
Usage: | Usage: | ||
| − | |||
* first, build the library for your target system. Edit the makefile in dolfs/libdolfs and uncomment the SYSTARGET line to match your system (gamecube or wii). Run "make" then "make install". The library and include are copied to your libogc/ installation. | * first, build the library for your target system. Edit the makefile in dolfs/libdolfs and uncomment the SYSTARGET line to match your system (gamecube or wii). Run "make" then "make install". The library and include are copied to your libogc/ installation. | ||
* next you need the tool to make a ramdisk. Run "make" in dolfs/ to build dfspack. Note: this requires a working c++ compiler on your system... | * next you need the tool to make a ramdisk. Run "make" in dolfs/ to build dfspack. Note: this requires a working c++ compiler on your system... | ||
| − | |||
* Now you can use dfspack to build a ramdisk. Make a directory, fill it with files, then from the directory above: | * Now you can use dfspack to build a ramdisk. Make a directory, fill it with files, then from the directory above: | ||
| − | dfspack <directory> <ramdiskname> | + | :dfspack <directory> <ramdiskname> |
| − | This will put all the files in <directory> into a single file, <ramdiskname>.h | + | ::This will put all the files in <directory> into a single file, <ramdiskname>.h |
| − | |||
* #include "<ramdiskname>.h" at the top of your main source file | * #include "<ramdiskname>.h" at the top of your main source file | ||
* mount the ramdisk with dolfsInit(&<ramdiskname>); | * mount the ramdisk with dolfsInit(&<ramdiskname>); | ||
* read files from the ramdisk by prefix the path with <ramdiskname>: e.g. | * read files from the ramdisk by prefix the path with <ramdiskname>: e.g. | ||
| − | FILE *cfgfile = fopen("ramdisk:/config.h","r"); | + | :FILE *cfgfile = fopen("ramdisk:/config.h","r"); |
| − | |||
| − | |||
| − | |||
| − | + | == External link == | |
| + | Download and feedback to this tehskeen.com post: [http://www.tehskeen.com/forums/showthread.php?t=14277] | ||
Latest revision as of 01:31, 22 February 2023
| libdolfs | |
| General | |
|---|---|
| Author(s) | Hornpipe2 |
| Type | Library |
| Version | (initial) |
| Links | |
| Download | |
| Website | |
| Source | |
| ARCHIVISTS NEEDED |
| This homebrew application currently contains an invalid download link. It was either not caught in the web archive or on a forum that required registration to download files; which the Wayback Machine cannot index. PLEASE PROVIDE A NEW DOWNLOAD IF YOU HAVE THIS APPLICATION. |
libdolfs is a library for accessing a read-only ramdisk (attached to a .dol at compile-time) as though it were a regular filesystem. It provides a convenient way to include support data with an executable, esp. when porting some code where you don't want to change the underlying core to add an alternative to fread()... or when using psoload without an SD card.
This initial release does not support directory access, but does allow long filenames.
This software is in the public domain.
Usage and Sample Code
It's a lot like using bin2o to add binary data to the executable, but this library uses the Newlib devoptab structs to let you then access the data like any attached filesystem using fopen(), fread(), etc.
Usage:
- first, build the library for your target system. Edit the makefile in dolfs/libdolfs and uncomment the SYSTARGET line to match your system (gamecube or wii). Run "make" then "make install". The library and include are copied to your libogc/ installation.
- next you need the tool to make a ramdisk. Run "make" in dolfs/ to build dfspack. Note: this requires a working c++ compiler on your system...
- Now you can use dfspack to build a ramdisk. Make a directory, fill it with files, then from the directory above:
- dfspack <directory> <ramdiskname>
- This will put all the files in <directory> into a single file, <ramdiskname>.h
- #include "<ramdiskname>.h" at the top of your main source file
- mount the ramdisk with dolfsInit(&<ramdiskname>);
- read files from the ramdisk by prefix the path with <ramdiskname>: e.g.
- FILE *cfgfile = fopen("ramdisk:/config.h","r");
External link
Download and feedback to this tehskeen.com post: [1]