Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
explain_lchown_or_die(3)   Library Functions Manual   explain_lchown_or_die(3)

NAME
       explain_lchown_or_die - change ownership	of a file and report errors

SYNOPSIS
       #include	<libexplain/lchown.h>
       void explain_lchown_or_die(const	char *pathname,	int owner, int group);

DESCRIPTION
       The explain_lchown_or_die function is used to call the lchown(2)	system
       call.  On failure an explanation	will be	printed	 to  stderr,  obtained
       from  explain_lchown(3),	 and  then  the	 process terminates by calling
       exit(EXIT_FAILURE).

       This function is	intended to be used in a fashion similar to  the  fol-
       lowing example:
	      explain_lchown_or_die(pathname, owner, group);

       pathname
	       The  pathname,  exactly as to be	passed to the lchown(2)	system
	       call.

       owner   The owner, exactly as to	be  passed  to	the  lchown(2)	system
	       call.

       group   The  group,  exactly  as	 to  be	passed to the lchown(2)	system
	       call.

       Returns:
	       This function only returns on success.  On failure,  prints  an
	       explanation and exits.

SEE ALSO
       lchown(2)
	       change ownership	of a file

       explain_lchown(3)
	       explain lchown(2) errors

       exit(2) terminate the calling process

COPYRIGHT
       libexplain version 1.3
       Copyright (C) 2008 Peter	Miller

						      explain_lchown_or_die(3)

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=explain_lchown_or_die&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help