src/Headers/context.h

   1 /*
   2 ** Copyright (C) University of Virginia, Massachusetts Institue of Technology 1994-2001.
   3 ** See ../LICENSE for license information.
   4 **
   5 */
   6 /*
   7 ** context.h
   8 */
   9
  10 # ifndef CONTEXT_H
  11 # define CONTEXT_H
  12
  13 extern void context_pushLoc (void);
  14 extern void context_popLoc (void);
  15
  16 extern bool context_doMerge (void);
  17 extern bool context_doDump (void);
  18
  19 extern void context_resetAllFlags (void);
  20
  21 extern /*@unused@*/ cstring context_unparseFlagMarkers (void) /*@*/ ;
  22
  23 extern void context_enterDoWhileClause (void) /*@modifies internalState@*/ ;
  24
  25 extern bool context_hasMods (void);
  26
  27 extern bool context_isSystemDir (cstring p_dir) /*@*/ ;
  28
  29 extern /*@observer@*/ cstring context_selectedLibrary (void) /*@*/ ;
  30 extern bool context_usingPosixLibrary (void) /*@*/ ;
  31 extern bool context_usingAnsiLibrary (void) /*@*/ ;
  32 extern flagcode context_getLibrary (void) /*@*/ ;
  33 extern void context_setLibrary (flagcode) /*@modifies internalState@*/ ;
  34
  35 extern void context_setPreprocessing (void) /*@modifies internalState@*/;
  36 extern void context_clearPreprocessing (void) /*@modifies internalState@*/;
  37 extern bool context_isPreprocessing (void) /*@*/;
  38 extern bool context_loadingLibrary (void) /*@*/ ;
  39
  40 extern void context_setInCommandLine (void) /*@modifies internalState@*/ ;
  41 extern void context_clearInCommandLine (void) /*@modifies internalState@*/ ;
  42
  43 extern void context_checkGlobalScope (void) /*@modifies internalState@*/ ;
  44
  45 extern bool context_isInCommandLine (void) /*@*/ ;
  46 extern bool context_inXHFile (void) /*@*/ ;
  47
  48 extern void context_resetErrors (void);
  49
  50 extern int context_getLinesProcessed (void) /*@*/ ;
  51 extern int context_getSpecLinesProcessed (void) /*@*/ ;
  52
  53 extern bool context_setBoolName (void) /*@*/ ;
  54 extern /*@observer@*/ cstring context_getBoolName (void) /*@*/ ;
  55 extern /*@observer@*/ cstring context_printBoolName (void) /*@*/ ;
  56 extern /*@observer@*/ cstring context_getFalseName (void) /*@*/ ;
  57 extern /*@observer@*/ cstring context_getTrueName (void) /*@*/ ;
  58 extern /*@observer@*/ cstring context_getLarchPath (void) /*@*/ ;
  59 extern /*@observer@*/ cstring context_getLCLImportDir (void) /*@*/ ;
  60
  61 extern bool context_checkExport (uentry p_e) /*@*/ ;
  62 extern bool context_checkGlobMod (sRef p_el) /*@*/ ;
  63 extern bool context_checkGlobUse (uentry p_glob);
  64 extern bool context_checkAliasGlob (uentry p_glob);
  65 extern bool context_checkInternalUse (void);
  66 extern void context_recordFileModifies (/*@dependent@*/ sRefSet p_mods);
  67 extern void context_clearJustPopped (void);
  68 extern bool context_justPopped (void);
  69
  70 extern void context_enterTrueClause (exprNode p_e);
  71 extern void context_enterFalseClause (exprNode p_e);
  72 extern void context_exitClause (exprNode p_pred,
  73                                 exprNode p_tbranch, exprNode p_fbranch);
  74 extern void context_exitInnerSafe (void);
  75 extern void context_exitInnerPlain (void) /*@modifies internalState@*/ ;
  76
  77 extern bool context_inGlobalScope (void);
  78 extern bool context_inInnerScope (void);
  79 extern void context_setProtectVars (void);
  80
  81 extern int context_getLimit (void) /*@*/ ;
  82 extern bool context_unlimitedMessages (void) /*@*/ ;
  83
  84 extern void context_releaseVars (void);
  85 extern void context_sizeofReleaseVars (void);
  86 extern bool context_inProtectVars (void);
  87
  88 extern bool context_hasFileAccess (typeId p_t);
  89
  90 extern void context_hideShowscan (void);
  91 extern void context_unhideShowscan (void);
  92
  93 extern void context_setMode (cstring p_s);
  94 extern void context_setModeNoWarn (cstring p_s);
  95 extern void context_exitAllClauses (void);
  96 extern void context_exitAllClausesQuiet (void);
  97 extern bool context_inHeader (void);
  98
  99 extern /*@dependent@*/ /*@exposed@*/ fileTable context_fileTable (void) /*@*/ ;
 100
 101 extern /*@exposed@*/ messageLog context_messageLog (void);
 102 extern /*@dependent@*/ /*@observer@*/ cstring context_tmpdir (void);
 103
 104 extern void context_enterMTfile (void) /*@modifies internalState@*/ ;
 105 extern void context_exitMTfile (void) /*@modifies internalState@*/ ;
 106
 107 # ifndef NOLCL
 108 extern void context_enterLCLfile (void);
 109 extern void context_exitLCLfile (void);
 110 extern void context_enterImport (void) ;
 111 extern void context_leaveImport (void) ;
 112 extern void context_processedSpecLine (void) /*@modifies internalState@*/ ;
 113 extern int context_getLCLExpect (void) /*@*/ ;
 114 extern bool context_msgLh (void) /*@*/ ;
 115 extern bool context_inLCLLib (void) /*@globals internalState@*/ ;
 116 extern bool context_inImport (void) /*@globals internalState@*/ ;
 117 extern void context_resetSpecLines (void) /*@modifies internalState@*/ ;
 118 # endif
 119
 120 extern void context_exitMacroCache (void);
 121 extern void context_enterSuppressRegion (fileloc);
 122 extern void context_exitSuppressRegion (fileloc);
 123 extern void context_enterMacroFile (void);
 124 extern typeIdSet context_fileAccessTypes (void);
 125 extern void context_addFileAccessType (typeId p_t);
 126 extern void context_removeFileAccessType (typeId p_t);
 127 extern /*@observer@*/ uentryList context_getParams (void);
 128
 129 extern bool context_isSpecialFile (cstring p_fname);
 130 extern /*@observer@*/ cstring context_inFunctionName (void) /*@*/ ;
 131 extern ctype context_currentFunctionType (void) /*@*/ ;
 132 extern void context_exitCFile (void);
 133 extern void context_enterConstantMacro (/*@dependent@*/ /*@exposed@*/ uentry p_e);
 134 extern void context_enterMacro (/*@observer@*/ uentry p_e);
 135 extern void context_enterFunction (/*@exposed@*/ uentry p_e);
 136 extern void context_exitFunction (void);
 137 extern void context_initMod (void) /*@modifies internalState@*/ ;
 138 extern void context_enterInnerContext(void);
 139 extern void context_exitInner (exprNode p_exp);
 140 extern bool context_globAccess (sRef p_s);
 141 extern /*@observer@*/ globSet context_getUsedGlobs (void);
 142 extern bool context_hasAccess (typeId p_t);
 143 extern bool context_couldHaveAccess (typeId p_t);
 144 extern /*@only@*/ cstring context_unparse (void) /*@*/ ;
 145 extern void context_setFunctionDefined (fileloc p_loc);
 146 extern void context_setFlagTemp (flagcode p_f, bool p_b);
 147
 148 extern /*@unused@*/ void context_showFilelocStack (void) ;
 149
 150 extern bool context_getFlag (flagcode p_d) /*@*/ ;
 151 extern bool context_flagOn (flagcode p_f, fileloc p_loc) /*@*/ ;
 152
 153 extern int context_getLineLen (void) /*@*/ ;
 154 # define context_getLineLen()  ((int)context_getValue(FLG_LINELEN))
 155
 156 extern int context_getIndentSpaces (void) /*@*/ ;
 157 # define context_getIndentSpaces() ((int)context_getValue(FLG_INDENTSPACES))
 158
 159 extern int context_getValue (flagcode p_flag) /*@*/ ;
 160 extern void context_setValueAndFlag (flagcode p_flag, int p_val)
 161    /*@modifies internalState@*/ ;
 162
 163 extern /*@unused@*/ int context_getCounter (flagcode p_flag) /*@*/ ;
 164 extern /*@unused@*/ void context_incCounter (flagcode p_flag)
 165    /*@modifies internalState@*/ ;
 166 extern /*@unused@*/ void context_decCounter (flagcode p_flag)
 167    /*@modifies internalState@*/ ;
 168
 169 extern bool context_maybeSet (flagcode p_d) /*@*/ ;
 170
 171 extern /*@observer@*/ cstring context_getString (flagcode p_flag) /*@*/ ;
 172 extern void context_setString (flagcode p_flag, /*@only@*/ cstring p_val)
 173    /*@modifies internalState@*/ ;
 174
 175 extern void context_userSetFlag (flagcode p_f, bool p_b);
 176
 177 extern int context_getExpect (void) /*@*/ ;
 178
 179 extern /*@observer@*/ sRefSet context_modList(void);
 180 extern /*@exposed@*/ uentry context_getHeader(void) /*@*/;
 181 extern void context_usedGlobal (/*@exposed@*/ sRef p_el);
 182 extern void context_resetModeFlags (void);
 183 extern ctype context_typeofZero (void);
 184 extern ctype context_typeofOne (void);
 185 extern void context_enterFile (void);
 186 extern void context_enterUnknownMacro (/*@dependent@*/ /*@observer@*/ uentry p_e);
 187 extern char context_getCommentMarkerChar (void);
 188 extern void context_setCommentMarkerChar (char p_c);
 189 extern bool context_inMacroConstant (void) /*@*/ ;
 190 extern void context_returnFunction (void);
 191 extern bool context_processingMacros (void);
 192
 193 extern void context_saveLocation (void);
 194 extern /*@only@*/ fileloc context_getSaveLocation (void);
 195
 196 extern void context_setFileId (fileId p_s);
 197 extern void context_setFilename(fileId p_fid, int p_lineno)
 198    /*@globals fileloc g_currentloc; @*/
 199    /*@modifies g_currentloc@*/ ;
 200
 201 extern void context_fileSetFlag (flagcode p_f, ynm p_set, fileloc p_loc);
 202
 203 extern /*@unused@*/ /*@only@*/ cstring context_unparseAccess (void) /*@*/ ;
 204 extern bool context_inFunction(void) /*@*/ ;
 205 extern bool context_inFunctionLike (void) /*@*/ ;
 206
 207 extern void context_setMacroMissingParams (void);
 208 extern void context_resetMacroMissingParams (void);
 209 extern bool context_isMacroMissingParams (void) /*@*/ ;
 210 extern bool context_inUnknownMacro (void) /*@*/ ;
 211
 212 /*@observer@*/ cstring context_getDump (void) /*@*/ ;
 213 /*@observer@*/ cstring context_getMerge (void) /*@*/ ;
 214
 215 extern void context_incLineno (void);
 216 extern bool context_inSuppressRegion (void) /*@*/ ;
 217 extern void context_exitTrueClause (exprNode p_pred, exprNode p_tbranch);
 218 extern void context_destroyMod (void) /*@modifies internalState@*/ ;
 219 extern void context_addMacroCache (/*@only@*/ cstring p_def);
 220 extern void context_processAllMacros (void);
 221 extern void context_addComment (/*@only@*/ cstring p_def, fileloc p_loc);
 222 extern void context_enterSuppressLine (int p_count, fileloc p_loc);
 223 extern bool context_inSuppressZone (fileloc p_fl) /*@*/ ;
 224 extern void context_dumpModuleAccess (FILE *p_fout);
 225 extern void context_loadModuleAccess (FILE *p_in);
 226 extern bool context_inIterDef (void) /*@*/ ;
 227 extern bool context_inMacro (void) /*@*/ ;
 228 extern bool context_inIterEnd (void) /*@*/ ;
 229 extern ctype context_getRetType (void) /*@*/ ;
 230
 231 extern void context_enterIterDef (/*@observer@*/ uentry p_le);
 232 extern void context_enterIterEnd (/*@observer@*/ uentry p_le);
 233 extern void context_addBoolAccess (void);
 234 extern bool context_canAccessBool (void);
 235 extern void context_quietExitFunction (void);
 236
 237 /* speedy shortcuts for frequently used flags */
 238
 239 extern bool context_msgBoolInt (void) /*@*/ ;
 240 extern bool context_msgCharInt (void) /*@*/ ;
 241 extern bool context_msgEnumInt (void) /*@*/ ;
 242 extern bool context_msgPointerArith (void) /*@*/ ;
 243 extern bool context_msgStrictOps (void) /*@*/ ;
 244
 245 extern void context_exitStructInnerContext (void);
 246 extern void context_enterStructInnerContext (void);
 247 extern bool context_inRealFunction (void) /*@*/ ;
 248 extern void context_exitOrClause (exprNode p_pred, exprNode p_tbranch);
 249 extern void context_exitAndClause (exprNode p_pred, exprNode p_tbranch);
 250 extern void context_enterOrClause (exprNode p_e);
 251 extern void context_enterAndClause (exprNode p_e);
 252
 253 extern void context_enterForClause (exprNode p_e);
 254 extern void context_enterWhileClause (exprNode p_e);
 255
 256 extern void context_enterIterClause (void);
 257 extern void context_exitIterClause (exprNode p_body);
 258
 259 extern void context_exitWhileClause (exprNode p_pred, exprNode p_body);
 260 extern void context_exitDoWhileClause (exprNode p_pred);
 261 extern void context_exitForClause (exprNode p_forPred, exprNode p_body);
 262
 263 extern /*@only@*/ cstring context_unparseClauses (void) /*@*/ ;
 264 extern /*@observer@*/ globSet context_getGlobs (void) /*@*/ ;
 265
 266 extern /*@only@*/ cstring context_getMessageAnnote (void);
 267 extern void context_clearMessageAnnote (void);
 268 extern bool context_hasMessageAnnote (void);
 269 extern void context_setMessageAnnote (/*@only@*/ cstring p_s);
 270 extern bool context_suppressFlagMsg (flagcode p_flag, fileloc p_fl);
 271 extern bool context_suppressNotFlagMsg (flagcode p_flag, fileloc p_fl);
 272 extern void context_enterCaseClause (exprNode p_e);
 273 extern void context_enterSwitch (exprNode p_e);
 274 extern void context_exitSwitch (exprNode p_e, bool p_allpaths);
 275
 276 extern bool context_showFunction (void);
 277 extern void context_setShownFunction (void);
 278
 279 extern void context_clearAliasAnnote (void);
 280 extern cstring context_getAliasAnnote (void);
 281 extern bool context_hasAliasAnnote (void);
 282 extern void context_setAliasAnnote (/*@observer@*/ sRef p_s, /*@observer@*/ sRef p_t);
 283
 284 extern bool context_inDeepLoop (void) /*@globals internalState@*/ ;
 285 extern bool context_inDeepLoopSwitch (void) /*@globals internalState@*/ ;
 286 extern bool context_inConditional (void) /*@globals internalState@*/ ;
 287 extern bool context_inDeepSwitch (void) /*@globals internalState@*/ ;
 288
 289 extern clause context_breakClause (void);
 290 extern clause context_nextBreakClause (void);
 291
 292 extern bool context_anyErrors (void) /*@globals internalState@*/ ;
 293 extern void context_hasError (void) /*@modifies internalState@*/ ;
 294 extern int context_numErrors (void) /*@globals internalState@*/ ;
 295 extern bool context_neednl (void);
 296 extern void context_setNeednl (void);
 297
 298 extern bool context_inGlobalContext (void) /*@globals internalState@*/ ;
 299 extern bool context_inMacroFunction (void) /*@globals internalState@*/ ;
 300
 301 extern /*@observer@*/ cstring context_moduleName (void) /*@*/ ;
 302 extern void context_recordFileGlobals (/*@dependent@*/ globSet p_mods);
 303 extern void context_checkSuppressCounts (void) /*@modifies g_warningstream@*/ ;
 304
 305 extern bool context_inFunctionHeader (void) /*@globals internalState@*/ ;
 306 extern void context_enterFunctionHeader (void) /*@modifies internalState@*/ ;
 307 extern void context_exitFunctionHeader (void) /*@modifies internalState@*/ ;
 308
 309 extern bool context_inFunctionDeclaration (void) /*@globals internalState@*/ ;
 310 extern void context_enterFunctionDeclaration (/*@exposed@*/ uentry) /*@modifies internalState@*/ ;
 311 extern void context_exitFunctionDeclaration (void) /*@modifies internalState@*/ ;
 312 extern void context_enterOldStyleScope (void) /*@modifies internalState@*/ ;
 313 extern void context_completeOldStyleFunction (/*@exposed@*/ uentry p_e) /*@modifies internalState@*/ ;
 314
 315 extern ctype context_boolImplementationType (void) /*@*/ ;
 316 extern /*@observer@*/ /*@null@*/ annotationInfo
 317    context_lookupAnnotation (cstring p_annot) /*@*/ ;
 318
 319 extern /*@observer@*/ metaStateTable context_getMetaStateTable (void)
 320      /*@globals internalState@*/ ;
 321
 322 extern /*@observer@*/ metaStateInfo context_lookupMetaStateInfo (cstring p_key)
 323      /*@globals internalState@*/ ;
 324
 325 extern void context_addAnnotation (/*@only@*/ annotationInfo)
 326      /*@modifies internalState@*/ ;
 327
 328 extern void context_addMetaState (/*@only@*/ cstring, /*@only@*/ metaStateInfo)
 329      /*@modifies internalState@*/ ;
 330
 331 extern valueTable context_createValueTable (sRef p_s, /*@only@*/ stateInfo p_sinfo)
 332      /*@globals internalState@*/ ;
 333
 334 extern valueTable context_createGlobalMarkerValueTable (/*@only@*/ stateInfo p_sinfo)
 335      /*@globals internalState@*/ ;
 336
 337 extern int context_getBugsLimit (void) /*@*/ ;
 338 # define context_getBugsLimit()  ((int)context_getValue(FLG_BUGSLIMIT))
 339
 340 /*drl 12/30/2001 these are some ugly functions that were added to facilitate struct annotations */
 341
 342
 343 extern bool hasInvariants (ctype p_ct);
 344
 345 /*drl 1/6/2001: I didn't think these functions were solid enough to include in the
 346   stable  release of splint.  I commented them out so that they won't break anything
 347   but didn't delete them because they will be fixed and included later
 348 */
 349
 350 /*extern void  setGlobalStructInfo(ctype p_ct, constraintList p_list); */
 351
 352 /*extern constraintList getInvariants (ctype p_ct); */
 353
 354 /* static int getSref (ctype ct, sRef s); */
 355
 356 /* sRef fixSref (ctype p_ct, sRef p_base, sRef p_fix); */
 357
 358 ctype context_setLastStruct (/*@returned@*/ ctype p_s) /*@modifies internalState@*/;
 359 ctype context_getLastStruct (/*@returned@*/ /*ctype p_s*/) /*@modifies internalState@*/;
 360
 361 /*drl added 2/4/2002*/
 362
 363   bool context_inOldSytleScope(void);
 364 # else
 365 # error "Multiple include"
 366 # endif
 367
 368
 369
 370
 371
 372
 373
 374