NAME

       mkc_check_decl  -  checks  for  define,  variable,  function,  type,  member  or  function
       prototype.

SYNOPSIS

       mkc_check_decl [OPTIONS] <check_type> <what> [headers...]

DESCRIPTION

       check_type is either  define, variable, func[0-9], funcordefine[0-9],  type,  member  or
       prototype.   Depending  on  its  value  mkc_check_decl  checks  respectively  for  define,
       variable, function with the specified number of arguments (or equivalent define in case of
       funcordefine[0-9]),  data  type,  member  of  structure  or  a  function  prototype in the
       specified headers by compiling a test program.  headers is either a single header file  or
       a  list  of  headers,  separated  by  comma.   As  a result mkc_check_decl prints either 1
       (success)  or  0  (failure)  to  stdout.   By   default,   temporary   and   cache   files
       _mkc_<check_type>_<what>_<lheader_h>.{c,err,res} are created under MKC_CACHEDIR directory.
       Here, lheader_h is the last header from comma-separated list headers.

OPTIONS

       -h     display help message

ENVIRONMENT

       CC     Compiler. By default cc is used.

       CPPFLAGS, CFLAGS
              Options passed to the compiler, for example  -I  for  additional  directories  that
              contain header files.

       MKC_VERBOSE
              If set to 1, verbose messages are output to stderr.

       MKC_SHOW_CACHED
              If set to 1 and MKC_VERBOSE is set to 1, cached results are output to stderr.

       MKC_COMMON_HEADERS
              List of header files to add to .c test program.

       MKC_CACHEDIR
              Directory  where  temporary and cache files are created.  If unset they are created
              in a current directory.

       MKC_NOCACHE
              All results are cached unless MKC_NOCACHE variable is set to 1.

       MKC_DELETE_TMPFILES
              If set to 1, temporary files are removed.

EXAMPLES

          mkc_check_decl define __GNUC__
          mkc_check_decl define RTLD_LAZY dlfcn.h
          mkc_check_decl define FTS_W sys/types.h,sys/stat.h,fts.h
          mkc_check_decl variable sys_errlist errno.h
          mkc_check_decl variable __malloc_hook malloc.h
          mkc_check_decl func3 poll poll.h
          mkc_check_decl func2 fgetln stdio.h
          mkc_check_decl type mbstate_t wchar.h
          mkc_check_decl type long-long
          mkc_check_decl member tm.tm_isdst time.h
          mkc_check_decl member ifreq.ifr_addr.sa_len net/if.h
          mkc_check_decl member struct-stat.st_mtimespec sys/stat.h
          mkc_check_decl prototype 'int connect(int,const struct sockaddr*,socklen_t)' sys/socket.h
          mkc_check_decl prototype 'int connect(int,struct sockaddr*,socklen_t)' sys/socket.h

C FILE CONTENT

       define
              #include <header1.h>
               ...
              #include <headerN.h>

              #if defined(WHAT)
              int func(void)
              {
                 return 0;
              }
              #else
              #error "WHAT is not a define"
              #endif

       variable
              #include <header1.h>
               ...
              #include <headerN.h>

              int func(void)
              {
                 return sizeof ((WHAT)) && (&WHAT != 0);
              }

       func3 (example for function with 3 arguments)
              #include <header1.h>
               ...
              #include <headerN.h>

              void func (void)
              {
                 if (WHAT) return;
                 WHAT(0,0,0);
              }

       funcordefine3 (example for function/define with 3 arguments)
              #include <header1.h>
               ...
              #include <headerN.h>

              void func (void)
              {
                 WHAT(0,0,0);
              }

       type
              #include <header1.h>
               ...
              #include <headerN.h>

              int func(void)
              {
                 return sizeof (WHAT);
              }

       member  (example for struct stat.st_mtimespec)
              #include <sys/stat.h>
              int func(void)
              {
                 struct_stat var;
                 return sizeof (var.st_mtimespec);
              }

       prototype (example for void ttt(int,char**) function)
              #include <header1.h>
               ...
              #include <headerN.h>

              void func (void);
              void func2 (void);

              void func (void)
              {
                 if (ttt) return;
              }

              void ttt(int, char**);

              void func2 (void)
              {
                 if (ttt) return;
              }

AUTHOR

       Aleksey Cheusov <vle@gmx.net>

                                           Mar 30, 2019                         MKC_CHECK_DECL(1)