diff options
Diffstat (limited to 'doc/Access.3')
| -rw-r--r-- | doc/Access.3 | 17 |
1 files changed, 8 insertions, 9 deletions
diff --git a/doc/Access.3 b/doc/Access.3 index daa4f53..b77e5fa 100644 --- a/doc/Access.3 +++ b/doc/Access.3 @@ -1,13 +1,11 @@ '\" -'\" Copyright (c) 1998-1999 Scriptics Corportation +'\" Copyright (c) 1998-1999 Scriptics Corporation '\" '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: Access.3,v 1.4 2001/07/31 19:12:05 vincentdarley Exp $ -'\" -.so man.macros .TH Tcl_Access 3 8.1 Tcl "Tcl Library Procedures" +.so man.macros .BS .SH NAME Tcl_Access, Tcl_Stat \- check file permissions and other attributes @@ -21,7 +19,7 @@ int int \fBTcl_Stat\fR(\fIpath\fR, \fIstatPtr\fR) .SH ARGUMENTS -.AS stat *statPtr in +.AS "struct stat" *statPtr out .AP char *path in Native name of the file to check the attributes of. .AP int mode in @@ -29,7 +27,7 @@ Mask consisting of one or more of R_OK, W_OK, X_OK and F_OK. R_OK, W_OK and X_OK request checking whether the file exists and has read, write and execute permissions, respectively. F_OK just requests checking for the existence of the file. -.AP stat *statPtr out +.AP "struct stat" *statPtr out The structure that contains the result. .BE @@ -44,7 +42,7 @@ rather than calling system level functions \fBaccess\fR and \fBstat\fR directly. First, the Windows implementation of both functions fixes some bugs in the system level calls. Second, both \fBTcl_Access\fR and \fBTcl_Stat\fR (as well as \fBTcl_OpenFileChannelProc\fR) hook -into a linked list of functions. This allows the possibity to reroute +into a linked list of functions. This allows the possibility to reroute file access to alternative media or access methods. .PP \fBTcl_Access\fR checks whether the process would be allowed to read, @@ -62,7 +60,7 @@ about the specified file. You do not need any access rights to the file to get this information but you need search rights to all directories named in the path leading to the file. The stat structure includes info regarding device, inode (always 0 on Windows), -priviledge mode, nlink (always 1 on Windows), user id (always 0 on +privilege mode, nlink (always 1 on Windows), user id (always 0 on Windows), group id (always 0 on Windows), rdev (same as device on Windows), size, last access time, last modification time, and creation time. @@ -72,4 +70,5 @@ is filled with data. Otherwise, -1 is returned, and no stat info is given. .SH KEYWORDS -stat access +stat, access + |