This file is indexed.

/usr/include/lam/lamdebug.h is in lam4-dev 7.1.4-3.1build1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
/*
 * Copyright (c) 2001-2002 The Trustees of Indiana University.  
 *                         All rights reserved.
 * Copyright (c) 1998-2001 University of Notre Dame. 
 *                         All rights reserved.
 * Copyright (c) 1994-1998 The Ohio State University.  
 *                         All rights reserved.
 * 
 * This file is part of the LAM/MPI software package.  For license
 * information, see the LICENSE file in the top level directory of the
 * LAM/MPI source distribution.
 * 
 * $HEADER$
 *
 *	Function:	- general debugging support
 */

#ifndef LAMDEBUG_H_
#define LAMDEBUG_H_

#include <lam_config.h>

#if __STDC__
#include <stdarg.h>
#else
#ifdef __cplusplus
#include <stdarg.h>
#else
#include <varargs.h>
#endif
#endif /* #if __STDC__ */


/*
 * Struct for holding / passing around info about opening debug streams
 */
typedef struct lam_debug_stream_info {
  int lds_fl_debug;
  int lds_fl_syslog;
  int lds_syslog_priority;
  char *lds_syslog_ident;
  char *lds_prefix;
  int lds_fl_stdout;
  int lds_fl_stderr;
  int lds_fl_file;
  int lds_fl_file_append;
  char *lds_file_suffix;
} lam_debug_stream_info_t;


#ifdef __cplusplus
extern "C" {
#endif

  /*
   * support for run-time debug mode
   *
   * DO NOT USE IN LAM LIBRARY (anything under share)
   * not all applications in LAM have the fl_* flags declared
   * or in use.
   */
#define DBUG		if (fl_debug) printf
#define VERBOSE		if (fl_verbose) printf
  
  /*
   * Simple syslog debugging support
   *
   * Also outputs to /tmp/<blah>/lam-debug-log.txt
   *
   * See share/etc/lamlog.c
   */
  void lamopenlog(char *ident);
  void lamlog(char *format, ...);
  void lamcloselog(void);

  /*
   * More generalized debugging output mechanism
   *
   * See share/etc/lamdebug.c
   */
  int lam_debug_open(lam_debug_stream_info_t *lds);
  int lam_debug_switch(int lam_debug_id, int fl_enable);
  void lam_debug(int lam_debug_id, char *format, ...);
  void lam_debug_output_low(int lam_debug_id, char *format, va_list arglist);
  void lam_debug_reopen_all(void);
  void lam_debug_close(int lam_debug_id);

  /*
   * LAM daemon-based communication debugging
   *
   * See share/etc/lamcommdebug.c
   */
#define LAM_COMM_DEBUG_ALL   0x0FFFFFFF
#define LAM_COMM_DEBUG_DLI   0x00000001
#define LAM_COMM_DEBUG_DLO   0x00000002
#define LAM_COMM_DEBUG_LOCAL 0x00000004

  void lam_comm_debug_open(int level, int where);
  void lam_comm_debug_local(int level, char *format, ...);
  void lam_comm_debug_dlo(int level, char *format, ...);
  void lam_comm_debug_dli(int level, char *format, ...);
  void lam_comm_debug_close(void);

  /*
   * Wrapper macros for speed-sensitive debugging
   *
   * Only enabled if LAM is compiled with --with-debug
   */
#if LAM_WANT_DEBUG
#define lam_debug_cond(a) lam_debug a ;
#define lamlog_cond(a) lamlog a ;
#define lam_comm_debug_local_cond(a) lam_comm_debug_local a ;
#define lam_comm_debug_dlo_cond(a) lam_comm_debug_dlo a ;
#define lam_comm_debug_dli_cond(a) lam_comm_debug_dli a ;

#else /* #if LAM_WANT_DEBUG */

#define lam_debug_cond(a)
#define lamlog_cond(a)
#define lam_comm_debug_local_cond(a)
#define lam_comm_debug_dlo_cond(a)
#define lam_comm_debug_dli_cond(a)

#endif /* #if LAM_WANT_DEBUG */

#ifdef __cplusplus
}
#endif

#endif /* #ifdef LAMDEBUG_H_ */