This file is indexed.

/usr/include/plplot/pldebug.h is in libplplot-dev 5.10.0+dfsg-1.

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
// $Id: pldebug.h 11998 2011-10-21 12:34:16Z andrewross $
//
//  Copyright (C) 1995 by Maurice J. LeBrun
//
//  Debugging support for PLplot.
//
//  This software may be freely copied, modified and redistributed without
//  fee provided that this copyright notice is preserved intact on all
//  copies and modified copies.
//
//  There is no warranty or other guarantee of fitness of this software.
//  It is provided solely "as is". The author(s) disclaim(s) all
//  responsibility and liability with respect to this software's usage or
//  its effect upon hardware or computer systems.
//

#ifndef __PLDEBUG_H__
#define __PLDEBUG_H__

#include <stdarg.h>

// For the truly desperate debugging task

#ifdef DEBUG_ENTER
#define dbug_enter( a ) \
    if ( plsc->debug )  \
        fprintf( stderr, "    entered %s (%s, line %d)\n", a, __FILE__, __LINE__ );

#else
#define dbug_enter( a )
#endif

// If we're using a debugging malloc, include the header file here

#ifdef DEBUGGING_MALLOC
#include <malloc.h>
#endif

//--------------------------------------------------------------------------
// pldebug()
//
// Included into every plplot source file to control debugging output.  To
// enable printing of debugging output, you must #define DEBUG before
// including plplotP.h or specify -DDEBUG in the compile line, for each file
// that you want to have debug output enabled.  When running the program you
// must in addition specify -debug.  This allows debugging output to tailored
// to many different circumstances but otherwise be fairly unobtrusive.
//
// Note, any file that actually uses pldebug() must also define NEED_PLDEBUG
// before the plplotP.h include.  This is to eliminate warnings caused by
// those files in which this is defined but never referenced.  All this could
// be much nicer if CPP had the abilities of m4, sigh..
//
// Syntax:
//	pldebug(label, format [, arg1, arg2, ...] );
//
// The label is typically the calling function name.
//--------------------------------------------------------------------------

#ifdef NEED_PLDEBUG
static void
pldebug( const char *label, ... )
{
#ifdef DEBUG
    va_list args;
    char    *fmt;

    if ( plsc->debug )
    {
        if ( plsc->termin )
            c_pltext();
        va_start( args, label );

        // print out identifying tag

        fprintf( stderr, "%s: ", label );

        // print out remainder of message
        // Need to get fmt BEFORE it's used in the vfprintf

        fmt = (char *) va_arg( args, char * );
        vfprintf( stderr, fmt, args );

        va_end( args );
        if ( plsc->termin )
            c_plgra();
    }
#else
    // Avoid warning about unused parameter
    (void) label;
#endif  // DEBUG
}
#endif  // NEED_PLDEBUG

#endif  // __PLDEBUG_H__