An alternative runtime for C11/C23 (mirror)
Go to file
bumbread 3b4da3a797 free user of the need to explicitly specifying ciabatta dependencies in the linker 2022-07-31 17:03:53 +11:00
doc Update assert.h 2022-07-30 13:07:34 +11:00
inc Update assert.h 2022-07-30 13:07:34 +11:00
src free user of the need to explicitly specifying ciabatta dependencies in the linker 2022-07-31 17:03:53 +11:00
test Add UTF-8 codepage support 2022-07-31 05:06:15 +11:00
.gitignore I have no idea but something for linux 2022-06-28 23:57:14 +11:00
.gitmodules Add UTF-8 codepage support 2022-07-31 05:06:15 +11:00
bake-test.cmd free user of the need to explicitly specifying ciabatta dependencies in the linker 2022-07-31 17:03:53 +11:00
bake.cmd wchar.h header formatting 2022-07-30 13:07:33 +11:00
readme free user of the need to explicitly specifying ciabatta dependencies in the linker 2022-07-31 17:03:53 +11:00
todo add todo items 2022-07-29 05:02:12 +11:00

readme

ABOUT
  Ciabatta  -  An implementation of CRT for x86-64 windows and linux platforms.
The  goal  is  to  provide  a  platform-independent  CRT  with  the  purpose of
explicitly  defining  some  of platform-defined behaviours in order to simplify
the development and providing additional functionality to aid the developers in
writing cross-platform applications.

Note that Undefined Behaviour is impossible to define on a CRT level, since the
semantics  of the language can only be changed at the compiler level. Sometimes
the  compilers will replace CRT function calls with builtin functions, which is
meant  as  an optimization, e.g. replacing some forms of prinf() with puts() or
replacing  strlen with an x86 rep movsb instruction. Even if ciabatta does have
a  specific  behaviour  under  given  UB  conditions,  that  behaviour  is  not
guaranteed.

The goals:
  - Providing  API  for sockets, unicode processing (not just encodings), maybe
    the  support  for  common  image  and  data  file  formats and other useful
    non-standard functionality.
  - Making  it  easy  to  port  the library to a new platform, e.g. a custom OS
    kernel or a different processor architecture.
  - Defining  implementation-defined  behaviours  of  some of the functions and
    explicitly documenting them.
  - Make it reasonably fast compared to MSVCRT and GLIBC.

PLATFORM SUPPORT
  OS/Kernel:
  - Windows (64-bit)
  - TODO: Linux
  Processor Architecture
  - x86-64

USAGE
  NOTE: libwinsane.obj can be obtained by running:
    bake -DNO_CRT
  In the libwinsane directory.
  Add the following flags to your compilation command:
    -I <path/to/ciabatta/inc> libwinsane.obj -nostdlib -mfma
  Don't forget to link to the following libraries:
    -lciabatta.lib

CONTRIBUTING
  Pull requests are always welcome.


LICENCE

TBD, but probably i'll make it MIT or WTFPL :kekw: