libcu

The CU standard library or libcu is the standard library for the C programming language implemented in CUDA, as specified in the ANSI C standard.

Quick Start

Optionally, Sentinel needs to be initialized and shutdown before any host-to-device access. An error will tell you to start Sentinel if such access is attempted prior to initialization.

A simple project startup looks like the following:

#include <cuda_runtimecu.h>
#include <sentinel.h>
...
// choose which GPU to run on and extend stack size (optional)
cudaErrorCheck(cudaSetDevice(gpuGetMaxGflopsDevice()));
cudaErrorCheck(cudaDeviceSetLimit(cudaLimitStackSize, 1024 * 5));
// main body
sentinelServerInitialize();
// sentinelRegisterFileUtils(); // Optional if using #file-utilities
...
code
...
sentinelServerShutdown();

Standard libraries are included with the original name prefixed by cu.

Example:

#include <stdlibcu.h>
...
int val = atoi("123");

Mulple compute targets are compiled, linking libcu to the proper compute target can enhance functionality and reduce startup times. On windows systems NuGet packages are provided instead of manual binding, see NuGet below.

Example with compute: 3.5.

libcu.35.a
libcu.fileutils.35.a - if using #file-utilities
note: .a is .lib on windows operating systems

NuGet

On windows systems NuGet packages can simplify libary integration.

Documents

This project follows the stardard libc interface.

• Learning by reference: documentation can be found in docs.
• Learning by tests: tests can be found in libcu.tests.

Contributing

If you would like to contribute to libcu to help the project along, consider these options:

• Improve our documentation. Documentation often gets over looked, but can be a large contributer to the success of a project.
• Submit a bug report (for an excellent guide on submitting good bug reports, read Painless Bug Tracking).
• Submit a feature request.
• Help verify submitted fixes for bugs.
• Help answer questions in the discussions list.
• Submit or update a unit test to help provide code coverage.
• Tell others about the project.
• Tell the developers how your using the product, or how much you appreciate the product!

General Guidelines

Please only contribute code which you wrote or have the rights to contribute. This project is licensed under the MIT license.