uvcc
libuv C++ bindings
uv::fs::chown Class Reference

Change ownership of a file. (Not implemented on Windows.) More...

#include "request-fs.hpp"

Inheritance diagram for uv::fs::chown:
uv::fs uv::request

Public Types

using on_request_t = std::function< void(chown _request) >
 The function type of the callback called when the chown request has completed.
 
- Public Types inherited from uv::fs
using uv_t = ::uv_fs_t
 
- Public Types inherited from uv::request
using uv_t = ::uv_req_t
 
using on_destroy_t = std::function< void(void *_data) >
 The function type of the callback called when the request object is about to be destroyed.
 

Public Member Functions

 chown (const chown &)=default
 
chownoperator= (const chown &)=default
 
 chown (chown &&) noexcept=default
 
chownoperator= (chown &&) noexcept=default
 
on_request_ton_request () const noexcept
 
file handle () const noexcept
 The file which this chown request has been running on. More...
 
const char * path () const noexcept
 The file path affected by request. More...
 
int run (uv::loop &_loop, const char *_path, ::uv_uid_t _uid, ::uv_gid_t _gid)
 Run the request. Change the owner and group of a file or directory specified by _path. More...
 
int run (file &_file, ::uv_uid_t _uid, ::uv_gid_t _gid)
 Run the request. Change the owner and group of the open _file. More...
 
 operator const uv_t * () const noexcept
 
 operator uv_t * () noexcept
 
- Public Member Functions inherited from uv::fs
 fs (const fs &)=default
 
fsoperator= (const fs &)=default
 
 fs (fs &&) noexcept=default
 
fsoperator= (fs &&) noexcept=default
 
::uv_fs_type fs_type () const noexcept
 The tag indicating a subtype of the filesystem request. More...
 
uv::loop loop () const noexcept
 The libuv loop that started this filesystem request and where completion will be reported.
 
 operator const uv_t * () const noexcept
 
 operator uv_t * () noexcept
 
- Public Member Functions inherited from uv::request
 request (const request &_that)
 
requestoperator= (const request &_that)
 
 request (request &&_that) noexcept
 
requestoperator= (request &&_that) noexcept
 
void swap (request &_that) noexcept
 
std::uintptr_t id () const noexcept
 
long nrefs () const noexcept
 The current number of existing references to the same object as this request variable refers to.
 
int uv_status () const noexcept
 The status value returned by the last executed libuv API function on this request.
 
on_destroy_ton_destroy () const noexcept
 
::uv_req_type type () const noexcept
 The tag indicating a libuv type of the request. More...
 
const char * type_name () const noexcept
 A string containing the name of the request type.
 
void *const & data () const noexcept
 The pointer to the user-defined arbitrary data. libuv and uvcc does not use this field.
 
void *& data () noexcept
 
int cancel () noexcept
 Cancel a pending request. More...
 
 operator const uv_t * () const noexcept
 
 operator uv_t * () noexcept
 
 operator bool () const noexcept
 Equivalent to (uv_status() >= 0).
 

Detailed Description

Change ownership of a file. (Not implemented on Windows.)

Definition at line 1477 of file request-fs.hpp.

Member Function Documentation

◆ handle()

file uv::fs::chown::handle ( ) const
inlinenoexcept

The file which this chown request has been running on.

It is guaranteed that it will be a valid instance at least within the request callback.

If the request was applied to a file path then the handle of the returned file is closed (i.e. uv::file::is_closing() == 1).

Definition at line 1529 of file request-fs.hpp.

◆ path()

const char* uv::fs::chown::path ( ) const
inlinenoexcept

The file path affected by request.

See also
libuv API documentation: uv_fs_t.path.

Definition at line 1537 of file request-fs.hpp.

◆ run() [1/2]

int uv::fs::chown::run ( uv::loop _loop,
const char *  _path,
::uv_uid_t  _uid,
::uv_gid_t  _gid 
)
inline

Run the request. Change the owner and group of a file or directory specified by _path.

See also
libuv API documentation: uv_fs_chown().
Linux: chown().
Note
If the request callback is empty (has not been set), the request runs synchronously.

Definition at line 1547 of file request-fs.hpp.

◆ run() [2/2]

int uv::fs::chown::run ( file _file,
::uv_uid_t  _uid,
::uv_gid_t  _gid 
)
inline

Run the request. Change the owner and group of the open _file.

See also
libuv API documentation: uv_fs_fchown().
Linux: fchown().
Note
If the request callback is empty (has not been set), the request runs synchronously.

Definition at line 1593 of file request-fs.hpp.


The documentation for this class was generated from the following file: