summaryrefslogtreecommitdiffstats
path: root/doc/SetErrno.3
diff options
context:
space:
mode:
authorjan.nijtmans <nijtmans@users.sourceforge.net>2024-04-12 21:40:07 (GMT)
committerjan.nijtmans <nijtmans@users.sourceforge.net>2024-04-12 21:40:07 (GMT)
commit210cf0b76156e1992b1de59ff795e8c0f6ed5172 (patch)
tree933500cc39909d7687e92a84c303566df9ac41df /doc/SetErrno.3
parentd11173cdc111089c9694c56cb6c1c4c4b6c9c5ac (diff)
downloadtcl-210cf0b76156e1992b1de59ff795e8c0f6ed5172.zip
tcl-210cf0b76156e1992b1de59ff795e8c0f6ed5172.tar.gz
tcl-210cf0b76156e1992b1de59ff795e8c0f6ed5172.tar.bz2
Add missing documentation for TIP 598 Tcl_WinConvertError
Diffstat (limited to 'doc/SetErrno.3')
-rw-r--r--doc/SetErrno.311
1 files changed, 10 insertions, 1 deletions
diff --git a/doc/SetErrno.3 b/doc/SetErrno.3
index c202e2e..84d7553 100644
--- a/doc/SetErrno.3
+++ b/doc/SetErrno.3
@@ -8,7 +8,7 @@
.so man.macros
.BS
.SH NAME
-Tcl_SetErrno, Tcl_GetErrno, Tcl_ErrnoId, Tcl_ErrnoMsg \- manipulate errno to store and retrieve error codes
+Tcl_SetErrno, Tcl_GetErrno, Tcl_ErrnoId, Tcl_ErrnoMsg, Tcl_WinConvertError \- manipulate errno to store and retrieve error codes
.SH SYNOPSIS
.nf
\fB#include <tcl.h>\fR
@@ -25,10 +25,16 @@ const char *
const char *
\fBTcl_ErrnoMsg\fR(\fIerrorCode\fR)
.sp
+void
+\fBTcl_WinConvertError\fR(\fIwinErrorCode\fR)
+.fi
.SH ARGUMENTS
.AS int errorCode
.AP int errorCode in
A POSIX error code such as \fBENOENT\fR.
+.AS unsigned int winErrorCode in
+.AP DWORD winErrorCode in
+A Windows or Winsock error code such as \fBERROR_FILE_NOT_FOUND\fR.
.BE
.SH DESCRIPTION
@@ -61,6 +67,9 @@ that corresponds to the value of its
typically the value returned by \fBTcl_GetErrno\fR.
The strings returned by these functions are
statically allocated and the caller must not free or modify them.
+.PP
+\fBTcl_WinConvertError\fR (Windows only) maps the passed Windows or Winsock
+error code to a POSIX error and stores it in \fBerrno\fR.
.SH KEYWORDS
errno, error code, global variables