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

FreeBSD Manual Pages

  
 
  

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

NAME
       explain_opendir_or_die -	open a directory and report errors

SYNOPSIS
       #include	<libexplain/opendir.h>
       DIR *explain_opendir_or_die(const char *pathname);

DESCRIPTION
       The explain_opendir_or_die function is used to call the opendir(3) sys-
       tem call.  On failure an	explanation will be  printed  to  stderr,  ob-
       tained  from  explain_opendir(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:
	      DIR *dir = explain_opendir_or_die(pathname);

       pathname
	       The  pathname, exactly as to be passed to the opendir(3)	system
	       call.

       Returns:
	       On success, a pointer to	the  directory	stream.	  On  failure,
	       prints an explanation and exits,	does not return.

SEE ALSO
       opendir(3)
	       open a directory

       explain_opendir(3)
	       explain opendir(3) errors

       exit(2) terminate the calling process

COPYRIGHT
       libexplain version 1.3
       Copyright (C) 2008 Peter	Miller

						     explain_opendir_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_opendir_or_die&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help