通讯编程

开发平台：
Visual C++

Access.3：源码内容
							'"
'" 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.8 2002/07/01 18:24:38 jenglish Exp $
'" 
.so man.macros
.TH Tcl_Access 3 8.1 Tcl "Tcl Library Procedures"
.BS
.SH NAME
Tcl_Access, Tcl_Stat - check file permissions and other attributes
.SH SYNOPSIS
.nf
fB#include <tcl.h>fR
.sp
int
fBTcl_AccessfR(fIpathfR, fImodefR)
.sp
int
fBTcl_StatfR(fIpathfR, fIstatPtrfR)
.SH ARGUMENTS
.AS "struct stat" *statPtr in
.AP char *path in
Native name of the file to check the attributes of.
.AP int mode in
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 "struct stat" *statPtr out
The structure that contains the result.
.BE
.SH DESCRIPTION
.PP
As of Tcl 8.4, the object-based APIs fBTcl_FSAccessfR and
fBTcl_FSStatfR should be used in preference to fBTcl_AccessfR and
fBTcl_StatfR, wherever possible.
.PP
There are two reasons for calling fBTcl_AccessfR and fBTcl_StatfR
rather than calling system level functions fBaccessfR and fBstatfR
directly.  First, the Windows implementation of both functions fixes
some bugs in the system level calls.  Second, both fBTcl_AccessfR
and fBTcl_StatfR (as well as fBTcl_OpenFileChannelProcfR) hook
into a linked list of functions.  This allows the possibility to reroute
file access to alternative media or access methods.
.PP
fBTcl_AccessfR checks whether the process would be allowed to read,
write or test for existence of the file (or other file system object)
whose name is pathname.   If pathname is a symbolic link on Unix,
then permissions of the file referred by this symbolic link are
tested.
.PP
On success (all requested permissions granted), zero is returned.  On
error (at least one bit in mode asked for a permission that is denied,
or some other  error occurred), -1 is returned.
.PP
fBTcl_StatfR fills the stat structure fIstatPtrfR with information
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),
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.
.PP
If fIpathfR exists, fBTcl_StatfR returns 0 and the stat structure
is filled with data.  Otherwise, -1 is returned, and no stat info is
given.
.SH KEYWORDS
stat, access

						