Tcl_Access man page on OpenDarwin

Man page or keyword search:  
man Server   3202 pages
apropos Keyword Search (all sections)
Output format
OpenDarwin logo
[printable version]

Tcl_Access(3)		    Tcl Library Procedures		 Tcl_Access(3)

______________________________________________________________________________

NAME
       Tcl_Access, Tcl_Stat - check file permissions and other attributes

SYNOPSIS
       #include <tcl.h>

       int
       Tcl_Access(path, mode)

       int
       Tcl_Stat(path, statPtr)

ARGUMENTS
       char	     *path	(in)	  Native name of the file to check the
					  attributes of.

       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   permis‐
					  sions,   respectively.    F_OK  just
					  requests checking for the  existence
					  of the file.

       struct stat   *statPtr	(out)	  The	structure  that	 contains  the
					  result.
_________________________________________________________________

DESCRIPTION
       As of Tcl 8.4, the object-based APIs Tcl_FSAccess and Tcl_FSStat should
       be used in preference to Tcl_Access and Tcl_Stat, wherever possible.

       There  are  two reasons for calling Tcl_Access and Tcl_Stat rather than
       calling system level functions access and stat  directly.   First,  the
       Windows	implementation of both functions fixes some bugs in the system
       level  calls.   Second,	both  Tcl_Access  and  Tcl_Stat	 (as  well  as
       Tcl_OpenFileChannelProc)	 hook  into  a linked list of functions.  This
       allows the possibility to reroute file access to alternative  media  or
       access methods.

       Tcl_Access  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 per‐
       missions of the file referred by this symbolic link are tested.

       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.

       Tcl_Stat fills the stat structure statPtr 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 regard‐
       ing 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.

       If  path	 exists,  Tcl_Stat  returns 0 and the stat structure is filled
       with data.  Otherwise, -1 is returned, and no stat info is given.

KEYWORDS
       stat, access

Tcl				      8.1			 Tcl_Access(3)
[top]

List of man pages available for OpenDarwin

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
...................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net