i8087 / mlib

A nonstandard C library for MikeOS API.

mlib

The goal of mlib is to create a clean and nice nonstandard C library for MikeOS that respects the cdecl calling convention. mlib is a C wrapper for all of the MikeOS APIs and it's completely written in assembly (nasm). Currently, the project has finally been finished but it's still maintained. This library should only be used with programs running on MikeOS 4.6.1 and up.

Building

Before you get started, you'll need to have NASM installed on your system. To build mlib, simply run the build script. If you're using Windows, run build-win.bat. If you're using Linux, run build-linux.sh. The output should be an object file, mlib.a, in the root directory of mlib. Use mlib.h in .\include and include mlib.a with your program when compiling. SmallerC is a great compiler for MikeOS.

Example

A small hello world program looks like this:

#include "mlib.h"

int main(int argc, char *argv[]) {
    print_string("Hello, world!\r\n");
    return 0;
}

Contributing

Any kind of contributing is greatly appreciated and submitting an issue or suggestion is also helpful! A list of contributers can be found here.

Licensing

This project is licensed under "Simplified BSD" and can be found in the LICENSE file.

Dependencies

• NASM

mlib's Issues

os_input_string size limit

MikeOS 4.6 will require an additional parameter for the function os_input_string. This should be implement soon as it's a quick fix.

long_int_negate

The MikeOS function long_int_negate takes and returns a 32-bit value held in DX:AX Unfortunately, SmallerC doesn't support long types, so a special structure should be used and implemented like the one below.

typedef struct b_int {
    int low;
    int high;
} b_int;

Program freezes MikeOS

Running a program built with mlib will make MikeOS freeze.

Mikedev Variables

Would probably be desirable to put the mikedev.inc defined keywords into mlib.h for use at the C level.

string_parse

The function string_parse returns multiple strings. A simple solution to the problem would be to create a structure that points to all of the strings.

args

argc and argv aren't handled properly in crt0.asm.

Documentation error in Disk API

I have found another error in the MikeOS documentation.

All disk functions use the carry flag to report a disk error, except os_get_file_list which returns a blank string. However, the MikeOS documentation fails to mention that os_create_file and os_remove_file use the carry flag to indicate an error.

I checked your implementation and found your 'load_file', 'create_file' and 'remove_file' functions do not handle the carry flag. Additionally, in 'get_file_size' you return zero as the file size if a disk error occurs, which may be misleading.

Todo List

Finish adding all of the functions for the following categories:

• Disk
• Keyboard
• Math
• Misc
• Ports
• Screen
• String
• Sound
• BASIC

long_into_to_string

Same problem as issue #3.