Changeset 9a0b008 in rtems


Ignore:
Timestamp:
Sep 25, 1998, 4:20:52 PM (21 years ago)
Author:
Wade A Smith <warm38@…>
Branches:
4.10, 4.11, 4.8, 4.9, master
Children:
64183e20
Parents:
165988d
Message:

Docmumented the access routine in for this file.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • doc/new_chapters/files.t

    r165988d r9a0b008  
    3636@item @code{stat} - Gets information about a file.
    3737@item @code{fstat} -
    38 @item @code{access} -
     38@item @code{access} - Check user's permissions for a file.
    3939@item @code{chmod} - Changes file mode
    4040@item @code{fchmod} -
     
    942942
    943943@page
    944 @subsection access -
    945 
    946 @subheading CALLING SEQUENCE:
    947 
    948 @ifset is-C
    949 @example
    950 int access(
    951 );
    952 @end example
    953 @end ifset
    954 
    955 @ifset is-Ada
    956 @end ifset
    957 
    958 @subheading STATUS CODES:
    959 
    960 @table @b
    961 @item E
    962 The
    963 
    964 @end table
    965 
    966 @subheading DESCRIPTION:
    967 
    968 @subheading NOTES:
     944@subsection access - Check user's permissions for a file
     945
     946@subheading CALLING SEQUENCE:
     947
     948@ifset is-C
     949@example
     950#include <unistd.h>
     951
     952int access(const char *pathname,
     953           int         mode
     954);
     955@end example
     956@end ifset
     957
     958@ifset is-Ada
     959@end ifset
     960
     961@subheading STATUS CODES:
     962
     963@table @b
     964@item EACCES
     965The requested access would be denied, either to the file itself or
     966one of the directories in @code{pathname}.
     967@item EFAULT
     968@code{Pathname} points outside your accessible address space.
     969@item EINVAL
     970@code{Mode} was incorrectly specified.
     971@item ENAMETOOLONG
     972@code{Pathname} is too long.
     973@item ENOENT
     974A directory component in @code{pathname} would have been accessible but
     975does not exist or was a dangling symbolic link.
     976@item ENOTDIR
     977A component used as a directory in @code{pathname} is not, in fact,
     978a directory.
     979@item ENOMEM
     980Insufficient kernel memory was available.
     981
     982@end table
     983
     984@subheading DESCRIPTION:
     985
     986@code{Access} checks whether the process would be allowed to read, write or
     987test for existence of the file (or other file system object) whose name is
     988@code{pathname}.  If @code{pathname} is a symbolic link permissions of the
     989file referred by this symbolic link are tested.
     990
     991@code{Mode} is a mask consisting of one or more of R_OK, W_OK, X_OK and F_OK.
     992
     993@subheading NOTES: None
    969994
    970995@page
Note: See TracChangeset for help on using the changeset viewer.