https://github.com/daleksla/posicxx

CXX-style wrappers around POSIX functionality for CXX11 onwards
https://github.com/daleksla/posicxx

cxx cxx11 make posix

Last synced: about 5 hours ago
JSON representation

CXX-style wrappers around POSIX functionality for CXX11 onwards

• Host: GitHub
• URL: https://github.com/daleksla/posicxx
• Owner: daleksla
• License: other
• Created: 2023-03-02T00:29:22.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2023-10-01T23:58:36.000Z (about 1 year ago)
• Last Synced: 2023-10-02T00:51:26.574Z (about 1 year ago)
• Topics: cxx, cxx11, make, posix
• Language: C++
• Homepage:
• Size: 313 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# posicxx

## README

CXX-style wrappers around POSIX functionality for CXX11 onwards.

### Summarising

If you're doing systems programming in C++ and don't want to write 3 >= lines for every system call being made to appropriately check for errors, then this library does this for you, using exception handling.

At the very least, this library provides thin wrappers, consisting of one-off calls to the POSIX API found in libc functionality but, enveloped in namespace `posicxx`, guarded with error-handling to report the correct `errno` value as a run-time retrievable value. For certain functionality, there are instead resource-managed containers (think RAII) & overloads for procedure to seamlessly utilise said containers in place of raw resources.

Status of wrapper implementations (if unspecified, assume only core wrapper exists / no additional interface(s)):

* aio.hh

* arpa/

  * inet.hh

* complex.hh

* ctype.hh

* dirent.hh

* dlfcn.hh

* fcntl.hh (pending)

* fenv.hh

* fmtmsg.hh

* fnmatch.hh

* ftw.hh

* glob.hh

* grp.hh

* iconv.hh

* inttypes.hh

* langinfo.hh

* libgen.hh

* locale.hh

* math.hh

* monetary.hh

* mqueue.hh

* ndbm.hh

* net/

  * if.hh

* netdb.hh

* netinet/

  * in.hh

  * tcp.hh

* nl_types.hh

* poll.hh

* pthread.hh

* pwd.hh

* regex.hh

* sched.hh

* search.hh

* semaphore.hh (pending)

  * Core Wrapper (done)

* setjmp.hh

* signal.hh

* spawn.hh

* stdio.hh

* stdlib.hh

* string.hh

* strings.hh

* stropts.hh

* sys/

  * ipc.hh

  * mman.hh

  * msg.hh

  * resource.hh

  * select.hh

  * sem.hh

  * shm.hh

  * socket.hh

    * Core Wrapper (done)

  * stat.hh

  * stavfs.hh

  * time.hh

  * timeb.hh

  * times.hh

  * uio.hh

  * un.hh

  * utsname.hh

  * wait.hh

* syslog.hh

* termios.hh

* tgmath.hh

* time.hh

* trace.hh

* ucontext.hh

* ulimit.hh

* unistd.hh (pending)

  * Core Wrapper (done)

* utime.hh

* utmpx.hh

* wchar.hh

* wctype.hh

* wordexp.hh

### Building

Building requires use of GNU `make` utility, with instructions listed in the `Makefile` file.

Number of commands available:

* `make`/`make all` - builds library

* `make clean` - deletes all compiled output

Documentation uses the `doxygen` tool.

Run `make -B docs` to generate up-to-date documentation.

### Using

You will need to include the relevant headers as you would for the libc alternatives

For example:

`#include `

...is now...

`#include `

This *does not include* files which merely contain macro values or functions

Note that the CXX headers will also include the libc equivalent also without adulterations.

You will need to link your binaries with `posicxx.a` at compile-time

See `docs/` for documentation.

***

See LICENSE for terms of usage.