Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/wavesoft/libcontextiso

Tiny library to create contextualization CD-ROM images
https://github.com/wavesoft/libcontextiso

Last synced: about 2 months ago
JSON representation

Tiny library to create contextualization CD-ROM images

Awesome Lists containing this project

README

        

-------------------------------------------------
Tiny Contextualization CD-ROM Creation Library
-------------------------------------------------

1. INTRODUCTION
===================

This library provides the bare minimum code that is required to create a valid ISO-9660 (CDFS) disk image.
The disk will contain only one file, called 'CONTEXT.SH' and it's contents can be specified using the build_simple_cdrom() function.

2. KNOWN LIMITATIONS
========================

I remind again that this is just a tiny library to create contextualization CD-ROM images.
It is designed to have small footprint and being able to create ISOs with configuration information that will not exceed 2KiB. Therefore there are many limitations. For example:

* This library can create CD-ROMs with *only* 1 file
* The maximum supported file size 2048 characters
* The maximum supported filename length is 12 characters (DOS 8+3)

3. USAGE
===========

To build the static library 'libcontextiso.a' simply type : make
To use this library, include the header 'include/contextiso.h' and link your code against 'libcontextiso.a'. The exported functions are:

char * build_simple_cdrom( "volume_name", "file.name", "contents", contents_size );
char * build_context_cdrom( "contents of CONTEXT.SH" );

Both functions return a string buffer with the contents of the CD-ROM image. The length of the returned buffer is CONTEXTISO_CDROM_SIZE bytes.

For an example see 'example.c'. To build type : make example

4. AUTHOR
============

Ioannis Charalampidis