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

FreeBSD Manual Pages

  
 
  

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

NAME
       explain_readdir_or_die -	read directory entry and report	errors

SYNOPSIS
       #include	<libexplain/readdir.h>
       struct dirent *explain_readdir_or_die(DIR *dir);

DESCRIPTION
       The explain_readdir_or_die function is used to call the readdir(2) sys-
       tem  call.   On	failure	 an explanation	will be	printed	to stderr, ob-
       tained from explain_readdir(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_readdir_or_die(dir);

       dir     The dir,	exactly	as to be passed	to the readdir(2) system call.

       Returns:
	       a pointer to a dirent structure,	 or  NULL  if  end-of-file  is
	       reached.	 On failure, prints an explanation and exits.

SEE ALSO
       readdir(2)
	       read directory entry

       explain_readdir(3)
	       explain readdir(2) errors

       exit(2) terminate the calling process

COPYRIGHT
       libexplain version 1.3
       Copyright (C) 2008 Peter	Miller

						     explain_readdir_or_die(3)

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

home | help