Syscalls

Syscalls are OS functions exposed by Ndless to C and assembly programs. This article describes the syscalls currently available with Ndless 1.7.

Your help is needed to make this list grow to a full-fledged library. Try to find new syscalls, test them and share them for integration in Ndless.

Functions marked with (*) are available only if the program is linked against Newlib, i.e. when the nspire-ld switch -nostdlib is not used.

Functions crossed-out are deprecated and shouldn't be used anymore.

C standard library

ctype.h

• isalnum
• isalpha
• iscntrl
• isdigit
• islower
• isprint
• isspace
• isupper
• isxdigit
• tolower
• toupper

errno.h

• errno

stdarg.h

• va_list
• va_start
• va_arg
• va_end

stdio.h

• fclose
• feof
• ferror
• fflush
• fgetc
• fgets
• fopen
• freopen
• fprintf
• fputs
• fread
• fseek
• ftell (since v3.1)
• fwrite
• puts
• printf
• remove
• rename
• rewind
• stderr
• stdin
• stdout
• sprintf
• ungetc
• vsprintf

stdlib.h

• abort (since v3.1)
• atoi
• atof
• calloc
• exit (*)
• free
• malloc
• realloc
• strtod
• strtol
• strtoul

string.h

• memcpy
• memcmp
• memmove
• memrev
• memset
• strcat
• strcoll
• strchr
• strcmp
• strcpy
• strcspn
• strerror
• strlen
• strncat
• strncmp
• strncpy
• strpbrk
• strrchr
• strspn
• strstr

C POSIX library

dirent.h

• opendir (since v3.1)
• readdir (since v3.1)
• closedir (since v3.1)

sys/stat.h

• mkdir
• stat

unistd.h

• chdir
• rmdir
• unlink
• truncate (since v3.1)

Nucleus

• int TCT_Local_Control_Interrupts(int mask): sets the interrupt mask. Returns the previous mask.
• int NU_Current_Dir(const char *drive, char *path): fills in path with the full path name of the current working directory. Use "A:" as drive. Returns 0 on success.
• int NU_Get_First(struct dstat *statobj, const char * pattern): (deprecated, use opendir()) given a pattern which contains both a path specifier and a search pattern, fills in the structure at statobj with information about the file and sets up internal parts of statobj to supply appropriate information for calls to NU_Get_Next. Returns non-zero if a match was not found.
• int NU_Get_Next(struct dstat *statobj): (deprecated, use readdir() and stat()) given a pointer to a DSTAT structure that has been set up by a call to NU_Get_First(), searches for the next match of the original pattern in the original path. Returns non-zero if found and updates statobj for subsequent calls to NU_Get_Next.
• void NU_Done(struct dstat *statobj): (deprecated, use closedir()) given a pointer to a DSTAT structure that has been set up by a call to NU_Get_First(), frees internal elements used by the statobj.
• NU_Set_Current_Dir(const char *name): Set the current working directory on the default drive.

TI-Nspire GUI

• void ascii2utf16(void *buf, const char *str, int max_size): converts the ASCII string str to the UTF-8 string buf of size max_size.
• void show_dialog_box2(int winid, const char *utf8_title, const char *utf8_msg): displays a dialog box of title utf8_title containing utf8_msg. utf8_title and utf8_msg are C strings converted with ascii2utf16(). winid must be 0 (deprecated since Ndless 2.0 and replaced with libndls's show_msgbox).

Miscellaneous

• int read_unaligned_longword(void *ptr)
• int read_unaligned_word(void *ptr)