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)

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

home | help