LinuxGuruz
  • Last 5 Forum Topics
    Replies
    Views
    Last post


The Web Only This Site
  • BOOKMARK

  • ADD TO FAVORITES

  • REFERENCES


  • MARC

    Mailing list ARChives
    - Search by -
     Subjects
     Authors
     Bodies





    FOLDOC

    Computing Dictionary




  • Text Link Ads






  • LINUX man pages
  • Linux Man Page Viewer


    The following form allows you to view linux man pages.

    Command:

    cap_set_file

    
    
    
    

    SYNOPSIS

           #include <sys/capability.h>
    
           cap_t cap_get_file(const char *path_p);
    
           int cap_set_file(const char *path_p, cap_t cap_p);
    
           cap_t cap_get_fd(int fd);
    
           int cap_set_fd(int fd, cap_t caps);
    
           Link with -lcap.
    
    
    

    DESCRIPTION

           cap_get_file() and cap_get_fd() allocate a capability state in  working
           storage  and  set  it to represent the capability state of the pathname
           pointed to by path_p or the file open on descriptor  fd.   These  func-
           tions  return  a  pointer  to  the newly created capability state.  The
           effects of reading the capability state from any file other than a reg-
           ular  file is undefined.  The caller should free any releasable memory,
           when the capability state in working storage is no longer required,  by
           calling cap_free() with the used cap_t as an argument.
    
           cap_set_file() and cap_set_fd() set the values for all capability flags
           for all capabilities for the pathname pointed to by path_p or the  file
           open  on  descriptor fd, with the capability state identified by cap_p.
           The new capability state of the file is completely  determined  by  the
           contents  of  cap_p.   A  NULL value for cap_p is used to indicate that
           capabilities for the file should be deleted.  For  these  functions  to
           succeed,  the  calling  process  must  have  the  effective capability,
           CAP_SETFCAP, enabled and either the effective user ID  of  the  process
           must  match  the  file  owner  or  the  calling  process  must have the
           CAP_FOWNER flag in its effective capability set.  The effects of  writ-
           ing the capability state to any file type other than a regular file are
           undefined.
    
    
    

    RETURN VALUE

           cap_get_file() and cap_get_fd() return a non-NULL value on success, and
           NULL on failure.
    
           cap_set_file() and cap_set_fd() return zero on success, and -1 on fail-
           ure.
    
           On failure, errno is  set  to  EACCES,  EBADFD,  ENAMETOOLONG,  ENOENT,
           ENOMEM, ENOTDIR, EPERM, or EROFS.
    
    
    

    CONFORMING TO

           These  functions  are  specified by withdrawn POSIX.1e draft specifica-
           tion.
    
    
    

    NOTES

    
    
    

    SEE ALSO

           libcap(3),     cap_clear(3),     cap_copy_ext(3),     cap_from_text(3),
           cap_get_proc(3), cap_init(3), capabilities(7)
    
                                      2008-05-11                   CAP_GET_FILE(3)
    
  • MORE RESOURCE


  • Linux

    The Distributions





    Linux

    The Software





    Linux

    The News



  • MARKETING






  • Toll Free

webmaster@linuxguruz.com
Copyright © 1999 - 2016 by LinuxGuruz