Tcl_SetErrno, Tcl_GetErrno, Tcl_ErrnoId, Tcl_ErrnoMsg − manipulate errno to store and retrieve error codes


#include <tcl.h>



const char *

const char *


int errorCode (in)

A POSIX error code such as ENOENT.



Tcl_SetErrno and Tcl_GetErrno provide portable access to the errno variable, which is used to record a POSIX error code after system calls and other operations such as Tcl_Gets. These procedures are necessary because global variable accesses cannot be made across module boundaries on some platforms.

Tcl_SetErrno sets the errno variable to the value of the errorCode argument C procedures that wish to return error information to their callers via errno should call Tcl_SetErrno rather than setting errno directly.

Tcl_GetErrno returns the current value of errno. Procedures wishing to access errno should call this procedure instead of accessing errno directly.

Tcl_ErrnoId and Tcl_ErrnoMsg return string representations of errno values. Tcl_ErrnoId returns a machine-readable textual identifier such as “EACCES” that corresponds to the current value of errno. Tcl_ErrnoMsg returns a human-readable string such as “permission denied” that corresponds to the value of its errorCode argument. The errorCode argument is typically the value returned by Tcl_GetErrno. The strings returned by these functions are statically allocated and the caller must not free or modify them.


errno, error code, global variables

More Linux Commands

Apache::TestTrace(3pm) - Helper output generation functions
This module exports a number of functions that make it easier generating various diagnostics messages in your programs in a consistent way and saves some keystr

gs(1) - Ghostscript (PostScript and PDF language interpreter
The gs (gswin32c, gswin32, gsos2) command invokes Ghostscript, an interpreter of Adobe Systems PostScript(tm) and Portable Document Format (PDF) languages. gs r

endutxent(3) - access utmp file entries - Linux manual page
New applications should use the POSIX.1-specified utmpx versions of these functions; see CONFORMING TO. utmpname() sets the name of the utmp-format file for the

unflatten(1) - adjust directed graphs to improve layout aspe
unflatten is a preprocessor to dot that is used to improve the aspect ratio of graphs having many leaves or disconnected nodes. The usual layout for such a grap

batcher(8) - Article batching for InterNetNews (Man Page)...
batcher reads a list of files and prepares news batches for the specified host. It is generally used to prepare UUCP feeds, but the resulting batches can be use

pam_misc_paste_env(3) - transcribing an environment to that
This function takes the supplied list of environment pointers and uploads its contents to the PAM environment. Success is indicated by PAM_SUCCESS. SEE ALSO pam

pluginviewer(8) - list loadable SASL plugins and their prope
pluginviewer can be used by a server administrator to troubleshoot SASL installations. The utility can list loadable (properly configured) client and server sid

libsensors(3) - publicly accessible functions provided by th
sensors_init() loads the configuration file and the detected chips list. If this returns a value unequal to zero, you are in trouble; you can not assume anythin

auto_execok(n) - standard library of Tcl procedures.........
Tcl includes a library of Tcl procedures for commonly-needed functions. The procedures defined in the Tcl library are generic ones suitable for use by many diff

makeg(1) - make a debuggable executable - Linux manual page
The makeg script runs make, passing it variable settings to create a debuggable target when used with a Makefile generated by imake. For example, it arranges fo

sgi2tiff(1) create a TIFF file from an SGI image file.......
sgi2tiff converts a file in the SGI image format to TIFF. By default, the TIFF image is created with data samples packed (PlanarConfiguration=1), compressed wit

pamdice(1) - slice a Netpbm image into many horizontally and
This program is part of Netpbm(1) pamdice reads a PAM, PBM, PGM, or PPM image as input and splits it horizontally and/or vertically into equal size pieces and w

We can't live, work or learn in freedom unless the software we use is free.