]> andersk Git - splint.git/blobdiff - lib/unix.h
Fixed branch state bug with definitely null values (reported by Jon Wilson).
[splint.git] / lib / unix.h
index e92db76127a835b5a6acaaf22555b8e79e21180b..769b88add2b43a963b16c0a3dfc31315f66ae185 100644 (file)
@@ -4,13 +4,63 @@
 
 /*@-nextlinemacros@*/
 
+/*
+** sys/types.h
+**
+** evans - 2001-08-27: from http://www.opengroup.org/onlinepubs/007908799/xsh/systypes.h.html
+*/
+
+typedef /*@integraltype@*/ blkcnt_t;
+typedef /*@integraltype@*/ blksize_t;
+
+/*@-redef@*/ /* These are also defined by ansi.h: */
+typedef /*@integraltype@*/ clock_t;
+typedef /*@integraltype@*/ dev_t;
+typedef /*@integraltype@*/ gid_t;
+typedef /*@unsignedintegraltype@*/ ino_t;
+typedef /*@integraltype@*/ mode_t;
+typedef /*@integraltype@*/ nlink_t;
+typedef /*@integraltype@*/ off_t;
+typedef /*@integraltype@*/ pid_t;
+typedef /*@integraltype@*/ time_t;
+typedef /*@integraltype@*/ uid_t;
+
+/*@=redef@*/
+
+typedef /*@integraltype@*/ clockid_t;
+typedef /*@unsignedintegraltype@*/ fsblkcnt_t;
+typedef /*@unsignedintegraltype@*/ fsfilcnt_t;
+typedef /*@integraltype@*/ id_t;
+
+typedef /*@integraltype@*/ key_t;
+typedef /*@integraltype@*/ pthread_attr_t;
+typedef /*@integraltype@*/ pthread_cond_t;
+typedef /*@integraltype@*/ pthread_condattr_t;
+typedef /*@integraltype@*/ pthread_key_t;
+typedef /*@integraltype@*/ pthread_mutex_t;
+typedef /*@integraltype@*/ pthread_mutexattr_t;
+typedef /*@integraltype@*/ pthread_once_t;
+typedef /*@integraltype@*/ pthread_rwlock_t;
+typedef /*@integraltype@*/ pthread_rwlockattr_t;
+typedef /*@integraltype@*/ pthread_t;
+typedef /*@signedintegraltype@*/ suseconds_t;
+typedef /*@integraltype@*/ timer_t;
+typedef /*@unsignedintegraltype@*/ useconds_t;
+
+   /*-------------------------------------------------------------
+     -------------------------------------------------------------
+   */
+
+   
 /*
 ** Extra stuff in some unixen, not in posix.
 */
 
-/*@unchecked@*/ int signgam;
+extern /*@unchecked@*/ int signgam;
 
+/*@-redef@*/ /* Defined by ansi: */
 typedef /*@integraltype@*/ clockid_t;
+/*@=redef@*/
 
 extern void bcopy (char *b1, /*@out@*/ char *b2, int length) 
    /*@modifies *b2@*/ ;  /* Yes, the second parameter is the out param! */
@@ -45,9 +95,6 @@ extern size_t
   fwrite_unlocked (void *pointer, size_t size, size_t num_items, FILE *stream)
   /*@modifies *stream;@*/ ;
 
-extern void funlockfile (FILE *file) /*@modifies *file;@*/ ;
-extern void flockfile (FILE *file) /*@modifies *file@*/ ;
-
 extern void /*@alt void * @*/ 
   memccpy (/*@returned@*/ /*@out@*/ void *s1, 
           /*@unique@*/ void *s2, int c, size_t n) 
@@ -57,18 +104,12 @@ extern int strcasecmp (char *s1, char *s2) /*@*/ ;
 extern int strncasecmp (char *s1, char *s2, int n) /*@*/ ;
 extern /*@null@*/ /*@only@*/ char *strdup (char *s) /*@*/ ;
 
-extern /*@null@*/ char *tempnam (char *dir, /*@null@*/ char *pfx) 
-   /*@modifies internalState@*/ ;
-
 extern /*@null@*/ /*@dependent@*/ char *
   index (/*@returned@*/ char *s, char c) /*@*/ ;
 
 extern /*@null@*/ /*@dependent@*/ char *
   rindex (/*@returned@*/ char *s, char c) /*@*/ ;
 
-extern /*@dependent@*/ /*@null@*/ FILE *popen (char *command, char *ttype)
-   /*@modifies fileSystem, errno@*/ ;
-extern int pclose (FILE *stream) /*@modifies fileSystem, *stream, errno@*/ ;
 
 extern double cbrt (double x) /*@modifies errno@*/ ;
 extern double rint (double x) /*@*/ ;
@@ -198,6 +239,11 @@ extern /*@unchecked@*/ char *tzname[];
 extern void tzset(void) /*@modifies daylight, timezone, tzname@*/ ;
 /*@=incondefs@*/
 
+/*@-redef@*/ /* Defined by ansi: */
+typedef /*@integraltype@*/ key_t;
+/*@-incondefs@*/ typedef long timer_t; /*@=incondefs@*/
+/*@=redef@*/
+
 typedef        unsigned char uchar_t;
 typedef        unsigned short ushort_t;
 typedef        unsigned int uint_t;
@@ -217,13 +263,11 @@ typedef short cnt_t;
 typedef        int chan_t;     
 typedef unsigned long rlim_t;
 typedef        int paddr_t;
-typedef /*@integraltype@*/ key_t;
 typedef        void *mid_t;
 typedef char slab_t[12];       
 typedef ulong_t        shmatt_t;       
 typedef ulong_t        msgqnum_t;      
 typedef ulong_t        msglen_t;
-typedef long timer_t;
 typedef        uchar_t uchar;
 typedef        ushort_t ushort;
 typedef        uint_t uint;
@@ -451,7 +495,7 @@ int getpeername (int s, /*@out@*/ struct sockaddr *name, size_t *namelen)
        /*@modifies *name, *namelen, errno@*/;
 
 int getsockname (int s, struct sockaddr *address, size_t *address_len)
-  /*?requires maxSet(address) > *address_len@*/ 
+  /*: can't do this? requires maxSet(address) >= (*address_len) @*/ 
   /*@modifies *address, *address_len, errno@*/;
 
 int getsockopt (int s, int level, int optname, /*@out@*/ void *optval, size_t *optlen)
@@ -524,27 +568,11 @@ socketpair (int d, int type, int protocol, /*@out@*/ int *sv)
 extern void psignal (int sig, const char *msg)
    /*@modifies fileSystem@*/;
 
-/*@unchecked@*/ extern char *optarg;
-/*@unchecked@*/ extern int optind;
-/*@unchecked@*/ extern int optopt;
-/*@unchecked@*/ extern int opterr;
-/*@unchecked@*/ extern int optreset;
-
-       extern int
-getopt (int argc, char * const *argv, const char *optstring)
-       /*@globals optarg, optind, optopt, opterr, optreset@*/
-       /*@modifies optarg, optind, optopt@*/;
-
        extern int
 setenv (const char *name, const char *value, int overwrite)
        /*@globals environ@*/
        /*@modifies *environ, errno@*/;
 
-       extern int
-putenv (const char *string)
-       /*@globals environ@*/
-       /*@modifies *environ, errno@*/;
-
        extern void
 unsetenv (const char *name)
        /*@globals environ@*/
@@ -680,9 +708,9 @@ mprotect (caddr_t addr, int len, int prot)
        /*@*/;
 
        extern int
-munmap (caddr_t addr, size_t len)
-       /*@*/;
-
+       int munmap (/*@only@*/ caddr_t addr, size_t len)
+     /*@modifies fileSystem, *addr, errno @*/;
+    
        extern int
 msync (caddr_t addr, int len, int flags)
        /*@*/;
@@ -824,7 +852,10 @@ lchown (const char *path, uid_t owner, gid_t group)
 
        extern int
 readlink (const char *path, /*@out@*/ char *buf, int size)
-     /*@modifies *buf, errno@*/ /*@ensures result <= size @*/;
+     /*@modifies *buf, errno@*/
+     /*drl 10/27/001*/
+     /*@requires maxSet(buf) >= (size - 1) @*/
+     /*@ensures result <= size @*/;
 
        extern int
 select (int mfd, fd_set /*@null@*/ *r, fd_set /*@null@*/ *w, fd_set /*@null@*/ *e, struct timeval *t)
@@ -1203,6 +1234,7 @@ setgroupent (int stayopen)
 ** struct stat replaces POSIX version - more required fields in Unix
 */
 
+/*@-redef@*/ /*@-matchfields@*/
 struct stat {
   dev_t     st_dev; /* ID of device containing file */
   ino_t     st_ino; /* file serial number */
@@ -1219,7 +1251,8 @@ struct stat {
                           this object.  In some filesystem types, this may
                           vary from file to file */
   blkcnt_t  st_blocks; /*  number of blocks allocated for this object */
-}
+} ;
+/*@=redef@*/ /*@=matchfields@*/
 
 /*@constant mode_t S_IFMT@*/
 /*@constant mode_t S_IFBLK@*/
@@ -1231,6 +1264,8 @@ struct stat {
 
 /*@constant mode_t S_IRWXU@*/
 /*@constant mode_t S_IRUSR@*/
+
+/*@-incondefs@*/ /*: probably wrong in posix.h? */
 /*@constant mode_t S_IWUSR@*/
 /*@constant mode_t S_IXUSR@*/
 /*@constant mode_t S_IRWXG@*/
@@ -1245,8 +1280,11 @@ struct stat {
 /*@constant mode_t S_ISGID@*/
 /*@constant mode_t S_ISVTX@*/
 
+/*@=incondefs@*/
+
 # if 0
-These are the old definitions - they don't appear to be in the Single UNIX Specification
+/*These are the old definitions - they don't appear to be in the Single UNIX Specification */
+
 /*@constant int S_ISTXT@*/
 /*@constant int S_IREAD@*/
 /*@constant int S_IWRITE@*/
@@ -1351,9 +1389,8 @@ getpmsg (int fd, /*@out@*/ struct strbuf *c, /*@out@*/ struct strbuf *d, int *b,
 putmsg (int fd, const struct strbuf *c, const struct strbuf *d, int *f)
        /*@modifies internalState, errno@*/;
 
-       extern int
-putpmsg (int fd, const struct strbuf *c, const struct strbuf *d, int b, int *f)
-       /*@modifies internalState, errno@*/;
+extern int putpmsg (int fd, const struct strbuf *c, const struct strbuf *d, int b, int *f)
+   /*@modifies internalState, errno@*/;
 
 /*________________________________________________________________________
  * sys/resource.h
@@ -1458,10 +1495,8 @@ struct servent *getservbyport_r (int port, /*@null@*/ const char *proto, /*@out@
 /*@null@*/ struct servent *getservent_r (struct servent *result, char *buffer, int buflen);
 
 int setservent (int stayopen);
-
 int endservent (void);
 
-
 extern int h_errno;
 
 /*@null@*/ /*@observer@*/ struct hostent *gethostbyname (/*@nullterminated@*/ /*@notnull@*/ const char *name)
@@ -1472,15 +1507,15 @@ struct hostent *gethostbyname_r (/*@nullterminated@*/ const char *name, /*@notnu
      /*@requires maxSet(buffer) >= bufsize@*/ ;
 
 /*@null@*/ /*@observer@*/ struct hostent *gethostbyaddr (/*@notnull@*/ const void *addr, size_t addrlen, int type) 
-     /*@requires maxRead(addr) == addrlen@*/ /*@i534 ??? is this right? */
+     /*@requires maxRead(addr) == addrlen@*/ /*:i534 ??? is this right? */
      /*@warn multithreaded "Unsafe in multithreaded applications, use gethostbyaddr_r instead"@*/ 
      /*@modifies h_errno@*/ ;
 
 struct hostent *gethostbyaddr_r (/*@notnull@*/ const void *addr, size_t addrlen, int type, 
                                 /*@returned@*/ /*@out@*/ struct hostent *hent, 
                                 /*@exposed@*/ /*@out@*/ char *buffer, int bufsize, /*@out@*/ int *h_errnop)
-     /*@requires maxRead(addr) == addrlen 
-          /\ maxSet(buffer) >= bufsize@*/ /*@i534 ??? is this right? */ ;
+     /*@requires maxRead(addr) == addrlen /\ maxSet(buffer) >= bufsize@*/
+     /*:i534 ??? is this right? */ ;
 
 /*@observer@*/ /*@null@*/ struct hostent *gethostent (void)
     /*@warn multithreaded "Unsafe in multithreaded applications, use gethostent_r instead"@*/ ;
@@ -1488,17 +1523,13 @@ struct hostent *gethostbyaddr_r (/*@notnull@*/ const void *addr, size_t addrlen,
 struct hostent *gethostent_r (/*@out@*/ /*@returned@*/ struct hostent *hent, /*@exposed@*/ /*@out@*/ char *buffer, int bufsize)
      /*@requires maxSet(buffer) >= bufsize@*/ ;
 
-     /*@i534 need to annotate these: */
-struct hostent *fgethostent(FILE *f);
+/*:i534 need to annotate these: */
 
+struct hostent *fgethostent(FILE *f);
 struct hostent *fgethostent_r(FILE*f, struct hostent *hent, char buffer, int bufsize);
-
 void sethostent(int stayopen);
-
 void endhostent(void);
-
 void herror(const char *string);
-
 char *hstrerror(int err);
 
 struct hostent {
@@ -1510,24 +1541,6 @@ struct hostent {
   /*@observer@*/ /*@nullterminated@*/ char *h_addr; /* first address in list (backward compatibility) */
 } ;
 
-/*
-** arpa/inet.h
-*/
-
-typedef uint32_t in_addr_t;
-
-struct in_addr
-{
-  in_addr_t s_addr;
-};
-
-typedef uint16_t in_port_t;
-
-in_addr_t htonl (in_addr_t hostlong) /*@*/ ;
-in_port_t htons (in_port_t hostshort) /*@*/ ;
-in_addr_t ntohl (in_addr_t netlong) /*@*/ ;
-in_port_t ntohs (in_port_t netshort) /*@*/ ;
-
 /*
 ** unistd.h
 */
@@ -1560,3 +1573,167 @@ char /*@alt int@*/ _tolower(/*@sef@*/ int /*@alt unsigned char@*/);
 # endif
 
 /* other ctype.h functions in ansi.h */
+
+/*
+** stdlib.h
+**
+** evans 2001-08-27 - added from http://www.opengroup.org/onlinepubs/007908799/xsh/drand48.html
+*/
+
+double drand48 (void) /*@modifies internalState@*/ ; 
+double erand48 (unsigned short int /*@-fixedformalarray@*/ xsubi[3] /*@=fixedformalarray@*/ ) 
+   /*@modifies internalState@*/ ; 
+
+void srand48 (long int seedval) /*@modifies internalState@*/ ; 
+
+/*
+** netinet/in.h
+**
+** evans 2001-08-27 - added from http://www.opengroup.org/onlinepubs/007908799/xns/netinetin.h.html
+*/
+
+typedef /*@unsignedintegraltype@*/ in_port_t; /* An unsigned integral type of exactly 16 bits. */
+typedef /*@unsignedintegraltype@*/ in_addr_t; /* An unsigned integral type of exactly 32 bits. */
+
+typedef /*@unsignedintegraltype@*/ sa_family_t;
+
+struct in_addr {
+  in_addr_t      s_addr;
+} ;
+
+struct sockaddr_in {
+  sa_family_t    sin_family;
+  in_port_t      sin_port;
+  struct in_addr sin_addr;
+  unsigned char  sin_zero[8];
+} ;
+
+
+/* The <netinet/in.h> header defines the following macros for use as values of the level argument of 
+   getsockopt() and setsockopt(): 
+ */
+
+/*@constant int IPPROTO_IP@*/
+/*@constant int IPPROTO_ICMP@*/
+/*@constant int IPPROTO_TCP@*/
+/*@constant int IPPROTO_UDP@*/
+
+/* The <netinet/in.h> header defines the following macros for use as destination addresses for connect(), sendmsg() and sendto(): 
+ */
+
+/*@constant in_addr_t INADDR_ANY@*/
+/*@constant in_addr_t INADDR_BROADCAST@*/
+
+/*
+** arpa/inet.h
+*/
+
+in_addr_t htonl (in_addr_t hostlong) /*@*/ ;
+in_port_t htons (in_port_t hostshort) /*@*/ ;
+in_addr_t ntohl (in_addr_t netlong) /*@*/ ;
+in_port_t ntohs (in_port_t netshort) /*@*/ ;
+
+/*
+** dirent.h
+**
+** evans 2001-08-27 - added from http://www.opengroup.org/onlinepubs/007908799/xsh/dirent.h.html
+*/
+
+/*@-redef@*/ /*@-matchfields@*/ /* Has d_ino field, not in posix (?) */
+
+struct dirent
+{
+  ino_t  d_ino;
+  char   d_name[];    
+} ;
+
+/*@=redef@*/ /*@=matchfields@*/
+
+typedef /*@abstract@*/ DIR;
+
+/*:i32 need to check annotations on these */
+
+int closedir (DIR *) /*:errorcode -1*/ ; 
+/*@null@*/ DIR *opendir(const char *) ;
+struct dirent *readdir(DIR *);
+int readdir_r(DIR *, struct dirent *, struct dirent **);
+void rewinddir(DIR *);
+void seekdir(DIR *, long int);
+long int telldir(DIR *);
+
+/*drl added these functions
+  stpcpy and stpncpy are found on linux but
+  don't seem to be present on other unixes
+
+  thanks to Jeff Johnson for pointing out that
+  these functions were in the unix library
+*/
+
+/* this function is like strcpy but it reutrns a pointer to the null terminated character in dest instead of the beginning of dest */
+
+extern char * stpcpy(/*@out@*/ /*@returned@*/ char * dest, const char * src)
+             /*@modifies *dest @*/
+     /*@requires maxSet(dest) >= maxRead(src) @*/
+     /*@ensures MaxRead(dest) == MaxRead (src) /\ MaxRead(result) == 0 /\ MaxSet(result) == ( maxSet(dest) - MaxRead(src) ); @*/;
+
+
+extern char * stpncpy(/*@out@*/ /*@returned@*/ char * dest,
+                     const char * src, size_t n)
+           /*@modifies *dest @*/
+   /*@requires MaxSet(dest) >= ( n - 1 ); @*/ /*@ensures MaxRead (src) >= MaxRead(dest) /\ MaxRead (dest) <= n; @*/
+  ; 
+
+  /* drl added 09-25-001
+     Alexander Ma pointed out these were missing 
+  */
+  
+int usleep (useconds_t useconds) /*@modifies systemState, errno@*/
+     /*error -1 sucess 0 */
+     /* warn opengroup unix specification recommends using setitimer(), timer_create(), timer_delete(), timer_getoverrun(), timer_gettime() or
+     timer_settime() instead of this interface. 
+     */
+     ;
+
+
+     /* drl added 10-27-001 */
+     /*@i23*/
+     
+     /*not sure what the exact size of this is
+       also can IPv6 use this function?
+      */
+     
+     char *inet_ntoa(struct in_addr in)
+     /*@ensures maxSet(result) <= 15 /\ maxRead(result) <= 15 @*/
+     ;
+
+
+     extern  double hypot(double x, double y) /*@modifies errno@*/ /*error errno only*/;
+
+
+     extern double j0(double x) /*@modifies errno @*/ /*error 0 or NaN */;
+ extern      double j1(double x) /*@modifies errno @*/ /*error 0 or NaN */;
+ extern      double jn(int n, double x) /*@modifies errno @*/ /*error 0 or NaN */;
+
+     extern double y0(double x) /*@modifies errno @*/  /*error NaN -HUGE_VAL 0.0 */     ;
+     extern      double y1 (double x) /*@modifies errno @*/  /*error NaN -HUGE_VAL 0.0 */;
+     extern      double yn (int n, double x)  /*@modifies errno @*/  /*error NaN -HUGE_VAL 0.0 */;
+
+     extern       double acosh(double x)  /*@modifies errno @*/ /*error errno and implementation-dependent(NaN if present) */ /*error NaN and may errno*/;
+     extern       double asinh(double x) /*@modifies errno @*/  /*error NaN and may errno */;
+     
+  extern        double atanh(double x) /*@modifies errno @*/ /*error errno and implementation-dependent(NaN if present) */ /*error NaN and may errno */ ;
+
+     extern         double lgamma(double x)  /*@modifies errno @*/  /*error NaN or HUGE_VAL may set errno */;
+     
+     extern int signgam ;
+     
+      extern      double erf(double x)  /*@modifies errno @*/  /*error NaN or 0 may set errno */;
+
+   extern      double erfc (double x) /*@modifies errno @*/  /*error NaN or 0
+                                       may set errno */;
+
+     
+
+     
+     
+
This page took 0.052741 seconds and 4 git commands to generate.