Changeset d3fc9e9d in rtems


Ignore:
Timestamp:
Oct 28, 1999, 7:25:46 PM (20 years ago)
Author:
Joel Sherrill <joel.sherrill@…>
Branches:
4.10, 4.11, 4.8, 4.9, master
Children:
dcb93155
Parents:
75e3651a
Message:

Added lstat().

File:
1 edited

Legend:

Unmodified
Added
Removed
  • doc/posix_users/files.t

    r75e3651a rd3fc9e9d  
    3838@item @code{stat} - Gets information about a file.
    3939@item @code{fstat} - Gets file status
     40@item @code{lstat} - Gets file status
    4041@item @code{access} - Check permissions for a file.
    4142@item @code{chmod} - Changes file mode
     
    14201421
    14211422int fstat(
    1422 int fildes,
    1423 struct stat *buf
     1423  int fildes,
     1424  struct stat *buf
    14241425);
    14251426@end example
     
    14451446@subheading NOTES:
    14461447
    1447 NONE
     1448If the filesystem object referred to by @code{fildes} is a
     1449link, then the information returned in @code{buf} refers
     1450to the destination of that link.  This is in contrast to
     1451@code{lstat()} which does not follow the link.
     1452
     1453@c
     1454@c
     1455@c
     1456@page
     1457@subsection lstat - Gets file status
     1458
     1459@findex lstat
     1460@cindex  gets file status
     1461
     1462@subheading CALLING SEQUENCE:
     1463
     1464@ifset is-C
     1465@example
     1466#include <sys/types.h>
     1467#include <sys/stat.h>
     1468
     1469int lstat(
     1470  int          fildes,
     1471  struct stat *buf
     1472);
     1473@end example
     1474@end ifset
     1475
     1476@ifset is-Ada
     1477@end ifset
     1478
     1479@subheading STATUS CODES:
     1480
     1481@table @b
     1482@item EBADF
     1483Invalid file descriptor
     1484
     1485@end table
     1486
     1487@subheading DESCRIPTION:
     1488
     1489The @code{lstat()} function obtains information about the file
     1490associated with @code{fildes} and writes it to the area pointed
     1491to by the @code{buf} argument.
     1492
     1493@subheading NOTES:
     1494
     1495If the filesystem object referred to by @code{fildes} is a
     1496link, then the information returned in @code{buf} refers
     1497to the link itself.  This is in contrast to @code{fstat()}
     1498which follows the link.
     1499
     1500The @code{lstat()} routine is defined by BSD 4.3 and SVR4
     1501and not included in POSIX 1003.1b-1996.
    14481502
    14491503@c
Note: See TracChangeset for help on using the changeset viewer.