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

FreeBSD Manual Pages

  
 
  

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

NAME
       explain_lchmod_or_die - change permissions of a file and	report errors

SYNOPSIS
       #include	<libexplain/lchmod.h>
       void explain_lchmod_or_die(const	char *pathname,	mode_t mode);
       int explain_lchmod_on_error(const char *pathname, mode_t	mode);

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

       The explain_lchmod_on_error function is used to call the	lchmod(2) sys-
       tem call. On failure an explanation will	be printed to stderr, obtained
       from the	explain_lchmod(3) function, but	still returns to the caller.

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

       mode    The mode, exactly as to be passed to the	lchmod(2) system call.

RETURN VALUE
       The  explain_lchmod_or_die  function  only returns on success, see lch-
       mod(2) for more information. On failure,	prints an explanation and  ex-
       its, it does not	return.

       The explain_lchmod_on_error function always returns the value return by
       the wrapped lchmod(2) system call.

EXAMPLE
       The explain_lchmod_or_die function is intended to be used in a  fashion
       similar to the following	example:
	      explain_lchmod_or_die(pathname, mode);

SEE ALSO
       lchmod(2)
	       change permissions of a file

       explain_lchmod(3)
	       explain lchmod(2) errors

       exit(2) terminate the calling process

COPYRIGHT
       libexplain version 1.3
       Copyright (C) 2012 Peter	Miller

						      explain_lchmod_or_die(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | EXAMPLE | SEE ALSO | COPYRIGHT

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

home | help