RGBCube/uutils-coreutils
1
Fork 0
mirror of https://github.com/RGBCube/uutils-coreutils synced 2025-07-29 12:07:46 +00:00
Code Issues Activity

perms: add some docs

Browse source
This commit is contained in:
Sylvestre Ledru 2020-12-12 14:43:56 +01:00
parent dca1f28085
commit f287309b72
1 changed files with 9 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

9
src/uucore/src/lib/features/perms.rs
View file

@ -16,6 +16,7 @@ use std::os::unix::fs::MetadataExt;
use std::os::unix::ffi::OsStrExt; use std::os::unix::ffi::OsStrExt;
use std::path::Path; use std::path::Path;
/// The various level of verbosity
#[derive(PartialEq, Clone, Debug)] #[derive(PartialEq, Clone, Debug)]
pub enum Verbosity { pub enum Verbosity {
Silent, Silent,
@ -24,6 +25,7 @@ pub enum Verbosity {
Normal, Normal,
} }
/// Actually perform the change of group on a path
fn chgrp<P: AsRef<Path>>(path: P, dgid: gid_t, follow: bool) -> IOResult<()> { fn chgrp<P: AsRef<Path>>(path: P, dgid: gid_t, follow: bool) -> IOResult<()> {
let path = path.as_ref(); let path = path.as_ref();
let s = CString::new(path.as_os_str().as_bytes()).unwrap(); let s = CString::new(path.as_os_str().as_bytes()).unwrap();
@ -41,6 +43,9 @@ fn chgrp<P: AsRef<Path>>(path: P, dgid: gid_t, follow: bool) -> IOResult<()> {
} }
} }
/// Perform the change of group on a path
/// with the various options
/// and error messages management
pub fn wrap_chgrp<P: AsRef<Path>>( pub fn wrap_chgrp<P: AsRef<Path>>(
path: P, path: P,
meta: &Metadata, meta: &Metadata,
@ -94,6 +99,7 @@ pub fn wrap_chgrp<P: AsRef<Path>>(
Ok(out) Ok(out)
} }
/// Actually perform the change of owner on a path
fn chown<P: AsRef<Path>>(path: P, duid: uid_t, dgid: gid_t, follow: bool) -> IOResult<()> { fn chown<P: AsRef<Path>>(path: P, duid: uid_t, dgid: gid_t, follow: bool) -> IOResult<()> {
let path = path.as_ref(); let path = path.as_ref();
let s = CString::new(path.as_os_str().as_bytes()).unwrap(); let s = CString::new(path.as_os_str().as_bytes()).unwrap();
@ -111,6 +117,9 @@ fn chown<P: AsRef<Path>>(path: P, duid: uid_t, dgid: gid_t, follow: bool) -> IOR
} }
} }
/// Perform the change of owner on a path
/// with the various options
/// and error messages management
pub fn wrap_chown<P: AsRef<Path>>( pub fn wrap_chown<P: AsRef<Path>>(
path: P, path: P,
meta: &Metadata, meta: &Metadata,