Changeset 433c5585 in rtems


Ignore:
Timestamp:
Sep 13, 1998, 1:44:28 PM (21 years ago)
Author:
Wade A Smith <warm38@…>
Branches:
4.10, 4.11, 4.8, 4.9, master
Children:
6c455f37
Parents:
08142b48
Message:

Changes the name of readdir, umask, mkdir, chmod, chown to cfg_readdir,
cfg_umask, cfg_mkdir, cfg_chmod, cfg_chown respectively.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • doc/new_chapters/confspace.t

    r08142b48 r433c5585  
    3131@item @code{cfg_children} - Get Node Entries
    3232@item @code{cfg_mark} - Set Configuration Space Option
    33 @item @code{readdir} - Reads a directory
    34 @item @code{umask} - Sets a file creation mask
     33@item @code{cfg_readdir} - Reads a directory
     34@item @code{cfg_umask} - Sets a file creation mask
    3535@item @code{link} - Creates a link to a file
    3636@item @code{unlink} - Removes a directory entry
    37 @item @code{mkdir} - Makes a directory
     37@item @code{cfg_mkdir} - Makes a directory
    3838@item @code{open} - Opens a file
    39 @item @code{chmod} - Changes file mode
    40 @item @code{chown} - Changes the owner and/or group of a file
     39@item @code{cfg_chmod} - Changes file mode
     40@item @code{{cfg_chown} - Changes the owner and/or group of a file
    4141@end itemize
    4242
     
    11331133
    11341134@page
    1135 @subsection readdir - Reads a directory
     1135@subsection cfg_readdir - Reads a directory
    11361136
    11371137@subheading CALLING SEQUENCE:
     
    11421142#include <dirent.h>
    11431143
    1144 struct dirent *readdir(
     1144struct dirent *cfg_readdir(
    11451145  DIR   *dirp
    11461146);
     
    11611161@subheading DESCRIPTION:
    11621162
    1163 The @code{readdir} function returns a pointer to a structure @code{dirent}
     1163The @code{cfg_readdir} function returns a pointer to a structure @code{dirent}
    11641164representing the next directory entry from the directory stream pointed to
    11651165by @code{dirp}.  On end-of-file, NULL is returned.
    11661166
    1167 The @code{readdir} function may (or may not) return entries for . or .. Your
     1167The @code{cfg_readdir} function may (or may not) return entries for . or .. Your
    11681168program should tolerate reading dot and dot-dot but not require them.
    11691169
    1170 The data pointed to be @code{readdir} may be overwritten by another call to
     1170The data pointed to be @code{cfg_readdir} may be overwritten by another call to
    11711171@code{readdir} for the same directory stream.  It will not be overwritten by
    11721172a call for another directory.
     
    12931293
    12941294@page
    1295 @subsection umask - Sets a file creation mask.
     1295@subsection cfg_umask - Sets a file creation mask.
    12961296
    12971297@subheading CALLING SEQUENCE:
     
    13021302#include <sys/stat.h>
    13031303
    1304 mode_t umask(
     1304mode_t cfg_umask(
    13051305  mode_t cmask
    13061306);
     
    13151315@subheading DESCRIPTION:
    13161316
    1317 The @code{umask} function sets the process file creation mask to @code{cmask}.
     1317The @code{cfg_umask} function sets the process file creation mask to @code{cmask}.
    13181318The file creation mask is used during @code{open}, @code{creat}, @code{mkdir},
    13191319@code{mkfifo} calls to turn off permission bits in the @code{mode} argument.
     
    14411441
    14421442@page
    1443 @subsection mkdir - Makes a directory
     1443@subsection cfg_mkdir - Makes a directory
    14441444
    14451445@subheading CALLING SEQUENCE:
     
    14501450#include <sys/stat.h>
    14511451
    1452 int mkdir(
     1452int cfg_mkdir(
    14531453  const char *path,
    14541454  mode_t      mode
     
    14861486@subheading DESCRIPTION:
    14871487
    1488 The @code{mkdir} function creates a new diectory named @code{path}.  The
     1488The @code{cfg_mkdir} function creates a new diectory named @code{path}.  The
    14891489permission bits (modified by the file creation mask) are set from @code{mode}.
    14901490The owner and group IDs for the directory are set from the effective user ID
     
    14971497
    14981498@page
    1499 @subsection chmod - Changes file mode.
     1499@subsection cfg_chmod - Changes file mode.
    15001500
    15011501@subheading CALLING SEQUENCE:
     
    15061506#include <sys/stat.h>
    15071507
    1508 int chmod(
     1508int cfg_chmod(
    15091509  const char *path,
    15101510  mode_t      mode
     
    15421542for the file named by @code{path} to @code{mode}.  If the effective user ID
    15431543does not match the owner of the file and the calling process does not have
    1544 the appropriate privileges, @code{chmod} returns -1 and sets @code{errno} to
     1544the appropriate privileges, @code{cfg_chmod} returns -1 and sets @code{errno} to
    15451545@code{EPERM}.
    15461546
     
    15481548
    15491549@page
    1550 @subsection chown - Changes the owner and/or group of a file.
     1550@subsection cfg_chown - Changes the owner and/or group of a file.
    15511551
    15521552@subheading CALLING SEQUENCE:
     
    15571557#include <unistd.h>
    15581558
    1559 int chown(
     1559int cfg_chown(
    15601560  const char *path,
    15611561  uid_t       owner,
     
    16011601Some systems consider it a security violation to allow the owner of a file to
    16021602be changed,  If users are billed for disk space usage, loaning a file to
    1603 another user could result in incorrect billing.  The @code{chown} function
     1603another user could result in incorrect billing.  The @code{cfg_chown} function
    16041604may be restricted to privileged users for some or all files.  The group ID can
    16051605still be changed to one of the supplementary group IDs.
Note: See TracChangeset for help on using the changeset viewer.