xref: /petsc/include/petsclog.h (revision 8b86dd2ee2f9cfc0672efa8d65ff1071d586f9de)
197bb86f7SLois Curfman McInnes /*
27588ac45SBarry Smith     Defines profile/logging in PETSc.
397bb86f7SLois Curfman McInnes */
426bd1501SBarry Smith #if !defined(PETSCLOG_H)
526bd1501SBarry Smith #define PETSCLOG_H
6ac09b921SBarry Smith 
7aaa7dc30SBarry Smith #include <petscsys.h>
8958c4211Shannah_mairs #include <petsctime.h>
9c8d78d4dSSatish Balay 
10ac09b921SBarry Smith /* SUBMANSEC = Sys */
11ac09b921SBarry Smith 
12fa2bb9feSLisandro Dalcin /* General logging of information; different from event logging */
133ca90d2dSJacob Faibussowitsch PETSC_EXTERN PetscErrorCode PetscInfo_Private(const char[], PetscObject, const char[], ...) PETSC_ATTRIBUTE_FORMAT(3, 4);
14fa2bb9feSLisandro Dalcin #if defined(PETSC_USE_INFO)
157d3de750SJacob Faibussowitsch #define PetscInfo(A, ...) PetscInfo_Private(PETSC_FUNCTION_NAME, ((PetscObject)A), __VA_ARGS__)
16fa2bb9feSLisandro Dalcin #else
177d3de750SJacob Faibussowitsch #define PetscInfo(A, ...) 0
18fa2bb9feSLisandro Dalcin #endif
19e94e781bSJacob Faibussowitsch 
207d3de750SJacob Faibussowitsch #define PetscInfo1(...) PETSC_DEPRECATED_MACRO("GCC warning \"Use PetscInfo() (since version 3.17)\"") PetscInfo(__VA_ARGS__)
217d3de750SJacob Faibussowitsch #define PetscInfo2(...) PETSC_DEPRECATED_MACRO("GCC warning \"Use PetscInfo() (since version 3.17)\"") PetscInfo(__VA_ARGS__)
225899db6dSLisandro Dalcin #define PetscInfo3(...) PETSC_DEPRECATED_MACRO("GCC warning \"Use PetscInfo() (since version 3.17)\"") PetscInfo(__VA_ARGS__)
237d3de750SJacob Faibussowitsch #define PetscInfo4(...) PETSC_DEPRECATED_MACRO("GCC warning \"Use PetscInfo() (since version 3.17)\"") PetscInfo(__VA_ARGS__)
247d3de750SJacob Faibussowitsch #define PetscInfo5(...) PETSC_DEPRECATED_MACRO("GCC warning \"Use PetscInfo() (since version 3.17)\"") PetscInfo(__VA_ARGS__)
257d3de750SJacob Faibussowitsch #define PetscInfo6(...) PETSC_DEPRECATED_MACRO("GCC warning \"Use PetscInfo() (since version 3.17)\"") PetscInfo(__VA_ARGS__)
267d3de750SJacob Faibussowitsch #define PetscInfo7(...) PETSC_DEPRECATED_MACRO("GCC warning \"Use PetscInfo() (since version 3.17)\"") PetscInfo(__VA_ARGS__)
277d3de750SJacob Faibussowitsch #define PetscInfo8(...) PETSC_DEPRECATED_MACRO("GCC warning \"Use PetscInfo() (since version 3.17)\"") PetscInfo(__VA_ARGS__)
287d3de750SJacob Faibussowitsch #define PetscInfo9(...) PETSC_DEPRECATED_MACRO("GCC warning \"Use PetscInfo() (since version 3.17)\"") PetscInfo(__VA_ARGS__)
297d3de750SJacob Faibussowitsch 
30e94e781bSJacob Faibussowitsch /*E
3187497f52SBarry Smith   PetscInfoCommFlag - Describes the method by which to filter `PetscInfo()` by communicator size
32e94e781bSJacob Faibussowitsch 
33*8b86dd2eSJacob Faibussowitsch   Used as an input for `PetscInfoSetFilterCommSelf()`
34e94e781bSJacob Faibussowitsch 
35*8b86dd2eSJacob Faibussowitsch $ `PETSC_INFO_COMM_ALL` - Default uninitialized value. `PetscInfo()` will not filter based on
36*8b86dd2eSJacob Faibussowitsch communicator size (i.e. will print for all communicators)
37*8b86dd2eSJacob Faibussowitsch $ `PETSC_INFO_COMM_NO_SELF` - `PetscInfo()` will NOT print for communicators with size = 1 (i.e. *_COMM_SELF)
38*8b86dd2eSJacob Faibussowitsch $ `PETSC_INFO_COMM_ONLY_SELF` - `PetscInfo()` will ONLY print for communicators with size = 1
39e94e781bSJacob Faibussowitsch 
40e94e781bSJacob Faibussowitsch   Level: intermediate
41e94e781bSJacob Faibussowitsch 
42db781477SPatrick Sanan .seealso: `PetscInfo()`, `PetscInfoSetFromOptions()`, `PetscInfoSetFilterCommSelf()`
43e94e781bSJacob Faibussowitsch E*/
44e94e781bSJacob Faibussowitsch typedef enum {
45e94e781bSJacob Faibussowitsch   PETSC_INFO_COMM_ALL       = -1,
46e94e781bSJacob Faibussowitsch   PETSC_INFO_COMM_NO_SELF   = 0,
47e94e781bSJacob Faibussowitsch   PETSC_INFO_COMM_ONLY_SELF = 1
48e94e781bSJacob Faibussowitsch } PetscInfoCommFlag;
49e94e781bSJacob Faibussowitsch 
50e94e781bSJacob Faibussowitsch PETSC_EXTERN const char *const PetscInfoCommFlags[];
51fa2bb9feSLisandro Dalcin PETSC_EXTERN PetscErrorCode    PetscInfoDeactivateClass(PetscClassId);
52fa2bb9feSLisandro Dalcin PETSC_EXTERN PetscErrorCode    PetscInfoActivateClass(PetscClassId);
53e94e781bSJacob Faibussowitsch PETSC_EXTERN PetscErrorCode    PetscInfoEnabled(PetscClassId, PetscBool *);
54e94e781bSJacob Faibussowitsch PETSC_EXTERN PetscErrorCode    PetscInfoAllow(PetscBool);
55e94e781bSJacob Faibussowitsch PETSC_EXTERN PetscErrorCode    PetscInfoSetFile(const char[], const char[]);
56e94e781bSJacob Faibussowitsch PETSC_EXTERN PetscErrorCode    PetscInfoGetFile(char **, FILE **);
57e94e781bSJacob Faibussowitsch PETSC_EXTERN PetscErrorCode    PetscInfoSetClasses(PetscBool, PetscInt, const char *const *);
58e94e781bSJacob Faibussowitsch PETSC_EXTERN PetscErrorCode    PetscInfoGetClass(const char *, PetscBool *);
59e94e781bSJacob Faibussowitsch PETSC_EXTERN PetscErrorCode    PetscInfoGetInfo(PetscBool *, PetscBool *, PetscBool *, PetscBool *, PetscInfoCommFlag *);
60*8b86dd2eSJacob Faibussowitsch PETSC_EXTERN PetscErrorCode    PetscInfoProcessClass(const char[], PetscInt, const PetscClassId[]);
61e94e781bSJacob Faibussowitsch PETSC_EXTERN PetscErrorCode    PetscInfoSetFilterCommSelf(PetscInfoCommFlag);
62e94e781bSJacob Faibussowitsch PETSC_EXTERN PetscErrorCode    PetscInfoSetFromOptions(PetscOptions);
63e94e781bSJacob Faibussowitsch PETSC_EXTERN PetscErrorCode    PetscInfoDestroy(void);
64fa2bb9feSLisandro Dalcin PETSC_EXTERN PetscBool         PetscLogPrintInfo; /* if true, indicates PetscInfo() is turned on */
65fa2bb9feSLisandro Dalcin 
66b859824cSBarry Smith /*MC
67b859824cSBarry Smith     PetscLogEvent - id used to identify PETSc or user events which timed portions (blocks of executable)
68b859824cSBarry Smith      code.
69b859824cSBarry Smith 
70b859824cSBarry Smith     Level: intermediate
71b859824cSBarry Smith 
72db781477SPatrick Sanan .seealso: `PetscLogEventRegister()`, `PetscLogEventBegin()`, `PetscLogEventEnd()`, `PetscLogStage`
73b859824cSBarry Smith M*/
74b859824cSBarry Smith typedef int PetscLogEvent;
75b859824cSBarry Smith 
76b859824cSBarry Smith /*MC
77b859824cSBarry Smith     PetscLogStage - id used to identify user stages (phases, sections) of runs - for logging
78b859824cSBarry Smith 
79b859824cSBarry Smith     Level: intermediate
80b859824cSBarry Smith 
81db781477SPatrick Sanan .seealso: `PetscLogStageRegister()`, `PetscLogStagePush()`, `PetscLogStagePop()`, `PetscLogEvent`
82b859824cSBarry Smith M*/
83b859824cSBarry Smith typedef int PetscLogStage;
84b859824cSBarry Smith 
858ba1e511SMatthew Knepley #define PETSC_EVENT 1311311
86014dd563SJed Brown PETSC_EXTERN PetscLogEvent PETSC_LARGEST_EVENT;
8797bb86f7SLois Curfman McInnes 
8819b02663SBarry Smith /* Global flop counter */
89014dd563SJed Brown PETSC_EXTERN PetscLogDouble petsc_TotalFlops;
90014dd563SJed Brown PETSC_EXTERN PetscLogDouble petsc_tmp_flops;
9119b02663SBarry Smith 
9231d06abdSBarry Smith /* We must make the following structures available to access the event
9331d06abdSBarry Smith      activation flags in the PetscLogEventBegin/End() macros. These are not part of the PETSc public
9431d06abdSBarry Smith      API and are not intended to be used by other parts of PETSc or by users.
95d49d4b11SBarry Smith 
96fa2bb9feSLisandro Dalcin      The code that manipulates these structures is in src/sys/logging/utils.
9731d06abdSBarry Smith */
98aa213bdcSJed Brown typedef struct _n_PetscIntStack *PetscIntStack;
996a6a9b46SSatish Balay 
100217044c2SLisandro Dalcin /* -----------------------------------------------------------------------------------------------------*/
101c60ec953SBarry Smith /*
102aa213bdcSJed Brown     PetscClassRegInfo, PetscClassPerfInfo - Each class has two data structures associated with it. The first has
103c60ec953SBarry Smith        static information about it, the second collects statistics on how many objects of the class are created,
104c60ec953SBarry Smith        how much memory they use, etc.
105c60ec953SBarry Smith 
106aa213bdcSJed Brown     PetscClassRegLog, PetscClassPerfLog - arrays of the PetscClassRegInfo and PetscClassPerfInfo for all classes.
107c60ec953SBarry Smith */
1086a6a9b46SSatish Balay typedef struct {
109c60ec953SBarry Smith   char        *name;    /* The class name */
110c60ec953SBarry Smith   PetscClassId classid; /* The integer identifying this class */
111aa213bdcSJed Brown } PetscClassRegInfo;
1126a6a9b46SSatish Balay 
1136a6a9b46SSatish Balay typedef struct {
1140700a824SBarry Smith   PetscClassId   id;           /* The integer identifying this class */
1156a6a9b46SSatish Balay   int            creations;    /* The number of objects of this class created */
1166a6a9b46SSatish Balay   int            destructions; /* The number of objects of this class destroyed */
1174851f57dSBarry Smith   PetscLogDouble mem;          /* The total memory allocated by objects of this class; this is completely wrong and should possibly be removed */
1184851f57dSBarry Smith   PetscLogDouble descMem;      /* The total memory allocated by descendents of these objects; this is completely wrong and should possibly be removed */
119aa213bdcSJed Brown } PetscClassPerfInfo;
1206a6a9b46SSatish Balay 
121aa213bdcSJed Brown typedef struct _n_PetscClassRegLog *PetscClassRegLog;
122aa213bdcSJed Brown struct _n_PetscClassRegLog {
123c60ec953SBarry Smith   int                numClasses; /* The number of classes registered */
124c60ec953SBarry Smith   int                maxClasses; /* The maximum number of classes */
125aa213bdcSJed Brown   PetscClassRegInfo *classInfo;  /* The structure for class information (classids are monotonicly increasing) */
126c60ec953SBarry Smith };
1276a6a9b46SSatish Balay 
128aa213bdcSJed Brown typedef struct _n_PetscClassPerfLog *PetscClassPerfLog;
129aa213bdcSJed Brown struct _n_PetscClassPerfLog {
130c60ec953SBarry Smith   int                 numClasses; /* The number of logging classes */
131c60ec953SBarry Smith   int                 maxClasses; /* The maximum number of classes */
132aa213bdcSJed Brown   PetscClassPerfInfo *classInfo;  /* The structure for class information (classids are monotonicly increasing) */
133c60ec953SBarry Smith };
134c60ec953SBarry Smith /* -----------------------------------------------------------------------------------------------------*/
135c60ec953SBarry Smith /*
136aa213bdcSJed Brown     PetscEventRegInfo, PetscEventPerfInfo - Each event has two data structures associated with it. The first has
137c60ec953SBarry Smith        static information about it, the second collects statistics on how many times the event is used, how
138c60ec953SBarry Smith        much time it takes, etc.
139c60ec953SBarry Smith 
140aa213bdcSJed Brown     PetscEventRegLog, PetscEventPerfLog - an array of all PetscEventRegInfo and PetscEventPerfInfo for all events. There is one
141c60ec953SBarry Smith       of these for each stage.
142c60ec953SBarry Smith 
143c60ec953SBarry Smith */
1446a6a9b46SSatish Balay typedef struct {
1456a6a9b46SSatish Balay   char        *name;       /* The name of this event */
146c60ec953SBarry Smith   PetscClassId classid;    /* The class the event is associated with */
147217044c2SLisandro Dalcin   PetscBool    collective; /* Flag this event as collective */
1486a6a9b46SSatish Balay #if defined(PETSC_HAVE_MPE)
1496a6a9b46SSatish Balay   int mpe_id_begin; /* MPE IDs that define the event */
1506a6a9b46SSatish Balay   int mpe_id_end;
1516a6a9b46SSatish Balay #endif
152aa213bdcSJed Brown } PetscEventRegInfo;
1536a6a9b46SSatish Balay 
154c60ec953SBarry Smith typedef struct {
155c60ec953SBarry Smith   int            id;                      /* The integer identifying this event */
156ace3abfcSBarry Smith   PetscBool      active;                  /* The flag to activate logging */
157ace3abfcSBarry Smith   PetscBool      visible;                 /* The flag to print info in summary */
158c60ec953SBarry Smith   int            depth;                   /* The nesting depth of the event call */
159c60ec953SBarry Smith   int            count;                   /* The number of times this event was executed */
160a42e5b54SMatthew G Knepley   PetscLogDouble flops, flops2, flopsTmp; /* The flops and flops^2 used in this event */
161a42e5b54SMatthew G Knepley   PetscLogDouble time, time2, timeTmp;    /* The time and time^2 taken for this event */
162217044c2SLisandro Dalcin   PetscLogDouble syncTime;                /* The synchronization barrier time */
163891e75beSMatthew G. Knepley   PetscLogDouble dof[8];                  /* The number of degrees of freedom associated with this event */
1645d68e14cSMatthew G. Knepley   PetscLogDouble errors[8];               /* The errors (user-defined) associated with this event */
165c60ec953SBarry Smith   PetscLogDouble numMessages;             /* The number of messages in this event */
166c60ec953SBarry Smith   PetscLogDouble messageLength;           /* The total message lengths in this event */
167c60ec953SBarry Smith   PetscLogDouble numReductions;           /* The number of reductions in this event */
168e3ed9ee7SBarry Smith   PetscLogDouble memIncrease;             /* How much the resident memory has increased in this event */
169e3ed9ee7SBarry Smith   PetscLogDouble mallocIncrease;          /* How much the maximum malloced space has increased in this event */
170e3ed9ee7SBarry Smith   PetscLogDouble mallocSpace;             /* How much the space was malloced and kept during this event */
171e3ed9ee7SBarry Smith   PetscLogDouble mallocIncreaseEvent;     /* Maximum of the high water mark with in event minus memory available at the end of the event */
172091bc5acSJunchao Zhang #if defined(PETSC_HAVE_DEVICE)
173bec0b493Shannah_mairs   PetscLogDouble CpuToGpuCount; /* The total number of CPU to GPU copies */
174bec0b493Shannah_mairs   PetscLogDouble GpuToCpuCount; /* The total number of GPU to CPU copies */
175bec0b493Shannah_mairs   PetscLogDouble CpuToGpuSize;  /* The total size of CPU to GPU copies */
176bec0b493Shannah_mairs   PetscLogDouble GpuToCpuSize;  /* The total size of GPU to CPU copies */
177958c4211Shannah_mairs   PetscLogDouble GpuFlops;      /* The flops done on a GPU in this event */
178958c4211Shannah_mairs   PetscLogDouble GpuTime;       /* The time spent on a GPU in this event */
179bec0b493Shannah_mairs #endif
180aa213bdcSJed Brown } PetscEventPerfInfo;
181c60ec953SBarry Smith 
182aa213bdcSJed Brown typedef struct _n_PetscEventRegLog *PetscEventRegLog;
183aa213bdcSJed Brown struct _n_PetscEventRegLog {
1846a6a9b46SSatish Balay   int                numEvents; /* The number of registered events */
1856a6a9b46SSatish Balay   int                maxEvents; /* The maximum number of events */
186aa213bdcSJed Brown   PetscEventRegInfo *eventInfo; /* The registration information for each event */
1876a6a9b46SSatish Balay };
1886a6a9b46SSatish Balay 
189aa213bdcSJed Brown typedef struct _n_PetscEventPerfLog *PetscEventPerfLog;
190aa213bdcSJed Brown struct _n_PetscEventPerfLog {
1916a6a9b46SSatish Balay   int                 numEvents; /* The number of logging events */
1926a6a9b46SSatish Balay   int                 maxEvents; /* The maximum number of events */
193aa213bdcSJed Brown   PetscEventPerfInfo *eventInfo; /* The performance information for each event */
1946a6a9b46SSatish Balay };
195c60ec953SBarry Smith /* ------------------------------------------------------------------------------------------------------------*/
196c60ec953SBarry Smith /*
197aa213bdcSJed Brown    PetscStageInfo - Contains all the information about a particular stage.
1986a6a9b46SSatish Balay 
199aa213bdcSJed Brown    PetscStageLog - An array of PetscStageInfo for each registered stage. There is a single one of these in the code.
200c60ec953SBarry Smith */
201aa213bdcSJed Brown typedef struct _PetscStageInfo {
2026a6a9b46SSatish Balay   char              *name;     /* The stage name */
203ace3abfcSBarry Smith   PetscBool          used;     /* The stage was pushed on this processor */
204aa213bdcSJed Brown   PetscEventPerfInfo perfInfo; /* The stage performance information */
205aa213bdcSJed Brown   PetscEventPerfLog  eventLog; /* The event information for this stage */
206aa213bdcSJed Brown   PetscClassPerfLog  classLog; /* The class information for this stage */
207aa213bdcSJed Brown } PetscStageInfo;
2086a6a9b46SSatish Balay 
209aa213bdcSJed Brown typedef struct _n_PetscStageLog *PetscStageLog;
210aa213bdcSJed Brown struct _n_PetscStageLog {
2116a6a9b46SSatish Balay   int              numStages; /* The number of registered stages */
2126a6a9b46SSatish Balay   int              maxStages; /* The maximum number of stages */
213aa213bdcSJed Brown   PetscIntStack    stack;     /* The stack for active stages */
214aa213bdcSJed Brown   int              curStage;  /* The current stage (only used in macros so we don't call PetscIntStackTop) */
215aa213bdcSJed Brown   PetscStageInfo  *stageInfo; /* The information for each stage */
216aa213bdcSJed Brown   PetscEventRegLog eventLog;  /* The registered events */
217aa213bdcSJed Brown   PetscClassRegLog classLog;  /* The registered classes */
2186a6a9b46SSatish Balay };
219217044c2SLisandro Dalcin /* -----------------------------------------------------------------------------------------------------*/
220fee518ebSJed Brown 
2213bb1ff40SBarry Smith PETSC_EXTERN PetscErrorCode PetscLogObjectParent(PetscObject, PetscObject);
2223bb1ff40SBarry Smith PETSC_EXTERN PetscErrorCode PetscLogObjectMemory(PetscObject, PetscLogDouble);
2233bb1ff40SBarry Smith 
224aa482453SBarry Smith #if defined(PETSC_USE_LOG) /* --- Logging is turned on --------------------------------*/
225aeeda9f6SJohn Fettig PETSC_EXTERN PetscStageLog  petsc_stageLog;
226f5d6ab90SLisandro Dalcin PETSC_EXTERN PetscErrorCode PetscLogGetStageLog(PetscStageLog *);
227f5d6ab90SLisandro Dalcin PETSC_EXTERN PetscErrorCode PetscStageLogGetCurrent(PetscStageLog, int *);
228f5d6ab90SLisandro Dalcin PETSC_EXTERN PetscErrorCode PetscStageLogGetEventPerfLog(PetscStageLog, int, PetscEventPerfLog *);
229614700edSBarry Smith 
230da63de55SLois Curfman McInnes /*
231da63de55SLois Curfman McInnes    Flop counting:  We count each arithmetic operation (e.g., addition, multiplication) separately.
232da63de55SLois Curfman McInnes 
233da63de55SLois Curfman McInnes    For the complex numbers version, note that
234da63de55SLois Curfman McInnes        1 complex addition = 2 flops
235da63de55SLois Curfman McInnes        1 complex multiplication = 6 flops,
236da63de55SLois Curfman McInnes    where we define 1 flop as that for a double precision scalar.  We roughly approximate
237da63de55SLois Curfman McInnes    flop counting for complex numbers by multiplying the total flops by 4; this corresponds
238da63de55SLois Curfman McInnes    to the assumption that we're counting mostly additions and multiplications -- and
239da63de55SLois Curfman McInnes    roughly the same number of each.  More accurate counting could be done by distinguishing
240da63de55SLois Curfman McInnes    among the various arithmetic operations.
241da63de55SLois Curfman McInnes  */
242da63de55SLois Curfman McInnes 
243aa482453SBarry Smith #if defined(PETSC_USE_COMPLEX)
244542d4b3fSSatish Balay #define PETSC_FLOPS_PER_OP 4.0
245da63de55SLois Curfman McInnes #else
246542d4b3fSSatish Balay #define PETSC_FLOPS_PER_OP 1.0
247bf3909cdSBarry Smith #endif
248bf3909cdSBarry Smith 
249f8bfbb56SSatish Balay /*@C
250ca0c957dSBarry Smith        PetscLogFlops - Log how many flops are performed in a calculation
251ca0c957dSBarry Smith 
252c3b874c4SJose E. Roman    Input Parameter:
253c3b874c4SJose E. Roman .   flops - the number of flops
254ca0c957dSBarry Smith 
255ca0c957dSBarry Smith    Notes:
256ca0c957dSBarry Smith      To limit the chance of integer overflow when multiplying by a constant, represent the constant as a double,
257ca0c957dSBarry Smith      not an integer. Use PetscLogFlops(4.0*n) not PetscLogFlops(4*n)
258ca0c957dSBarry Smith 
259ca0c957dSBarry Smith    Level: intermediate
260ca0c957dSBarry Smith 
261db781477SPatrick Sanan .seealso: `PetscLogView()`, `PetscLogGpuFlops()`
262ca0c957dSBarry Smith @*/
263ca0c957dSBarry Smith 
2649371c9d4SSatish Balay static inline PetscErrorCode PetscLogFlops(PetscLogDouble n) {
265dd19b90bSBarry Smith   PetscFunctionBegin;
266bf3909cdSBarry Smith #if defined(PETSC_USE_DEBUG)
2672c71b3e2SJacob Faibussowitsch   PetscCheck(n >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Cannot log negative flops");
268da63de55SLois Curfman McInnes #endif
269dd19b90bSBarry Smith   petsc_TotalFlops += PETSC_FLOPS_PER_OP * n;
270dd19b90bSBarry Smith   PetscFunctionReturn(0);
271dd19b90bSBarry Smith }
272fa2bb9feSLisandro Dalcin 
273fa2bb9feSLisandro Dalcin PETSC_EXTERN PetscErrorCode PetscGetFlops(PetscLogDouble *);
27477c4ece6SBarry Smith 
275aa482453SBarry Smith #if defined(PETSC_HAVE_MPE)
276014dd563SJed Brown PETSC_EXTERN PetscErrorCode PetscLogMPEBegin(void);
277014dd563SJed Brown PETSC_EXTERN PetscErrorCode PetscLogMPEDump(const char[]);
27877c4ece6SBarry Smith #endif
27977c4ece6SBarry Smith 
280014dd563SJed Brown PETSC_EXTERN PetscErrorCode (*PetscLogPLB)(PetscLogEvent, int, PetscObject, PetscObject, PetscObject, PetscObject);
281014dd563SJed Brown PETSC_EXTERN PetscErrorCode (*PetscLogPLE)(PetscLogEvent, int, PetscObject, PetscObject, PetscObject, PetscObject);
282014dd563SJed Brown PETSC_EXTERN PetscErrorCode (*PetscLogPHC)(PetscObject);
283014dd563SJed Brown PETSC_EXTERN PetscErrorCode (*PetscLogPHD)(PetscObject);
28477c4ece6SBarry Smith 
2859566063dSJacob Faibussowitsch #define PetscLogObjectParents(p, n, d) PetscMacroReturnStandard(for (int _i = 0; _i < (n); ++_i) PetscCall(PetscLogObjectParent((PetscObject)(p), (PetscObject)(d)[_i]));)
286fa2bb9feSLisandro Dalcin #define PetscLogObjectCreate(h)        ((PetscLogPHC) ? (*PetscLogPHC)((PetscObject)(h)) : 0)
287fa2bb9feSLisandro Dalcin #define PetscLogObjectDestroy(h)       ((PetscLogPHD) ? (*PetscLogPHD)((PetscObject)(h)) : 0)
2883ca90d2dSJacob Faibussowitsch PETSC_EXTERN PetscErrorCode PetscLogObjectState(PetscObject, const char[], ...) PETSC_ATTRIBUTE_FORMAT(2, 3);
289fa2bb9feSLisandro Dalcin 
2908ba1e511SMatthew Knepley /* Initialization functions */
291bb1d7374SBarry Smith PETSC_EXTERN PetscErrorCode PetscLogDefaultBegin(void);
292014dd563SJed Brown PETSC_EXTERN PetscErrorCode PetscLogAllBegin(void);
293bb1d7374SBarry Smith PETSC_EXTERN PetscErrorCode PetscLogNestedBegin(void);
294014dd563SJed Brown PETSC_EXTERN PetscErrorCode PetscLogTraceBegin(FILE *);
295014dd563SJed Brown PETSC_EXTERN PetscErrorCode PetscLogActions(PetscBool);
296014dd563SJed Brown PETSC_EXTERN PetscErrorCode PetscLogObjects(PetscBool);
297fa2bb9feSLisandro Dalcin PETSC_EXTERN PetscErrorCode PetscLogSetThreshold(PetscLogDouble, PetscLogDouble *);
2989371c9d4SSatish Balay PETSC_EXTERN PetscErrorCode PetscLogSet(PetscErrorCode (*)(int, int, PetscObject, PetscObject, PetscObject, PetscObject), PetscErrorCode (*)(int, int, PetscObject, PetscObject, PetscObject, PetscObject));
299fa2bb9feSLisandro Dalcin 
3008ba1e511SMatthew Knepley /* Output functions */
301014dd563SJed Brown PETSC_EXTERN PetscErrorCode PetscLogView(PetscViewer);
302f14045dbSBarry Smith PETSC_EXTERN PetscErrorCode PetscLogViewFromOptions(void);
303014dd563SJed Brown PETSC_EXTERN PetscErrorCode PetscLogDump(const char[]);
30431d06abdSBarry Smith 
3054dd65854SConnor Ward /* Status checking functions */
3064dd65854SConnor Ward PETSC_EXTERN PetscErrorCode PetscLogIsActive(PetscBool *);
3074dd65854SConnor Ward 
308fa2bb9feSLisandro Dalcin /* Stage functions */
309014dd563SJed Brown PETSC_EXTERN PetscErrorCode PetscLogStageRegister(const char[], PetscLogStage *);
310014dd563SJed Brown PETSC_EXTERN PetscErrorCode PetscLogStagePush(PetscLogStage);
311014dd563SJed Brown PETSC_EXTERN PetscErrorCode PetscLogStagePop(void);
312014dd563SJed Brown PETSC_EXTERN PetscErrorCode PetscLogStageSetActive(PetscLogStage, PetscBool);
313014dd563SJed Brown PETSC_EXTERN PetscErrorCode PetscLogStageGetActive(PetscLogStage, PetscBool *);
314014dd563SJed Brown PETSC_EXTERN PetscErrorCode PetscLogStageSetVisible(PetscLogStage, PetscBool);
315014dd563SJed Brown PETSC_EXTERN PetscErrorCode PetscLogStageGetVisible(PetscLogStage, PetscBool *);
316014dd563SJed Brown PETSC_EXTERN PetscErrorCode PetscLogStageGetId(const char[], PetscLogStage *);
317f5d6ab90SLisandro Dalcin 
3188ba1e511SMatthew Knepley /* Event functions */
319014dd563SJed Brown PETSC_EXTERN PetscErrorCode PetscLogEventRegister(const char[], PetscClassId, PetscLogEvent *);
320217044c2SLisandro Dalcin PETSC_EXTERN PetscErrorCode PetscLogEventSetCollective(PetscLogEvent, PetscBool);
321fa2bb9feSLisandro Dalcin PETSC_EXTERN PetscErrorCode PetscLogEventIncludeClass(PetscClassId);
322fa2bb9feSLisandro Dalcin PETSC_EXTERN PetscErrorCode PetscLogEventExcludeClass(PetscClassId);
323014dd563SJed Brown PETSC_EXTERN PetscErrorCode PetscLogEventActivate(PetscLogEvent);
324014dd563SJed Brown PETSC_EXTERN PetscErrorCode PetscLogEventDeactivate(PetscLogEvent);
325c00cb57fSBarry Smith PETSC_EXTERN PetscErrorCode PetscLogEventDeactivatePush(PetscLogEvent);
326c00cb57fSBarry Smith PETSC_EXTERN PetscErrorCode PetscLogEventDeactivatePop(PetscLogEvent);
327014dd563SJed Brown PETSC_EXTERN PetscErrorCode PetscLogEventSetActiveAll(PetscLogEvent, PetscBool);
328014dd563SJed Brown PETSC_EXTERN PetscErrorCode PetscLogEventActivateClass(PetscClassId);
329014dd563SJed Brown PETSC_EXTERN PetscErrorCode PetscLogEventDeactivateClass(PetscClassId);
3308c49a8d9SBarry Smith PETSC_EXTERN PetscErrorCode PetscLogEventGetId(const char[], PetscLogEvent *);
33113230571SMichael Lange PETSC_EXTERN PetscErrorCode PetscLogEventGetPerfInfo(int, PetscLogEvent, PetscEventPerfInfo *);
332891e75beSMatthew G. Knepley PETSC_EXTERN PetscErrorCode PetscLogEventSetDof(PetscLogEvent, PetscInt, PetscLogDouble);
3335d68e14cSMatthew G. Knepley PETSC_EXTERN PetscErrorCode PetscLogEventSetError(PetscLogEvent, PetscInt, PetscLogDouble);
3347a101e5eSJacob Faibussowitsch PETSC_EXTERN PetscErrorCode PetscLogPushCurrentEvent_Internal(PetscLogEvent);
3357a101e5eSJacob Faibussowitsch PETSC_EXTERN PetscErrorCode PetscLogPopCurrentEvent_Internal(void);
3368ba1e511SMatthew Knepley 
3378ba1e511SMatthew Knepley /* Global counters */
338014dd563SJed Brown PETSC_EXTERN PetscLogDouble petsc_irecv_ct;
339014dd563SJed Brown PETSC_EXTERN PetscLogDouble petsc_isend_ct;
340014dd563SJed Brown PETSC_EXTERN PetscLogDouble petsc_recv_ct;
341014dd563SJed Brown PETSC_EXTERN PetscLogDouble petsc_send_ct;
342014dd563SJed Brown PETSC_EXTERN PetscLogDouble petsc_irecv_len;
343014dd563SJed Brown PETSC_EXTERN PetscLogDouble petsc_isend_len;
344014dd563SJed Brown PETSC_EXTERN PetscLogDouble petsc_recv_len;
345014dd563SJed Brown PETSC_EXTERN PetscLogDouble petsc_send_len;
346014dd563SJed Brown PETSC_EXTERN PetscLogDouble petsc_allreduce_ct;
347014dd563SJed Brown PETSC_EXTERN PetscLogDouble petsc_gather_ct;
348014dd563SJed Brown PETSC_EXTERN PetscLogDouble petsc_scatter_ct;
349014dd563SJed Brown PETSC_EXTERN PetscLogDouble petsc_wait_ct;
350014dd563SJed Brown PETSC_EXTERN PetscLogDouble petsc_wait_any_ct;
351014dd563SJed Brown PETSC_EXTERN PetscLogDouble petsc_wait_all_ct;
352014dd563SJed Brown PETSC_EXTERN PetscLogDouble petsc_sum_of_waits_ct;
3538ba1e511SMatthew Knepley 
354e3ed9ee7SBarry Smith PETSC_EXTERN PetscBool PetscLogMemory;
355e3ed9ee7SBarry Smith 
356fa2bb9feSLisandro Dalcin PETSC_EXTERN PetscBool      PetscLogSyncOn; /* true if logging synchronization is enabled */
35762872c28SLisandro Dalcin PETSC_EXTERN PetscErrorCode PetscLogEventSynchronize(PetscLogEvent, MPI_Comm);
35862872c28SLisandro Dalcin 
35962872c28SLisandro Dalcin #define PetscLogEventSync(e, comm) \
3609371c9d4SSatish Balay   (((PetscLogPLB && petsc_stageLog->stageInfo[petsc_stageLog->curStage].perfInfo.active && petsc_stageLog->stageInfo[petsc_stageLog->curStage].eventLog->eventInfo[e].active) ? PetscLogEventSynchronize((e), (comm)) : 0))
36177c4ece6SBarry Smith 
36252e6d16bSBarry Smith #define PetscLogEventBegin(e, o1, o2, o3, o4) \
3639371c9d4SSatish Balay   ((PetscLogPLB && petsc_stageLog->stageInfo[petsc_stageLog->curStage].perfInfo.active && petsc_stageLog->stageInfo[petsc_stageLog->curStage].eventLog->eventInfo[e].active) ? (((*PetscLogPLB)((e), 0, (PetscObject)(o1), (PetscObject)(o2), (PetscObject)(o3), (PetscObject)(o4))) || PetscLogPushCurrentEvent_Internal(e)) : 0)
364043328b6SSatish Balay 
36552e6d16bSBarry Smith #define PetscLogEventEnd(e, o1, o2, o3, o4) \
3669371c9d4SSatish Balay   ((PetscLogPLE && petsc_stageLog->stageInfo[petsc_stageLog->curStage].perfInfo.active && petsc_stageLog->stageInfo[petsc_stageLog->curStage].eventLog->eventInfo[e].active) ? (((*PetscLogPLE)((e), 0, (PetscObject)(o1), (PetscObject)(o2), (PetscObject)(o3), (PetscObject)(o4))) || PetscLogPopCurrentEvent_Internal()) : 0)
36777c4ece6SBarry Smith 
368014dd563SJed Brown PETSC_EXTERN PetscErrorCode PetscLogEventGetFlops(PetscLogEvent, PetscLogDouble *);
369014dd563SJed Brown PETSC_EXTERN PetscErrorCode PetscLogEventZeroFlops(PetscLogEvent);
370003131ecSBarry Smith 
371ce85283eSBarry Smith /*
372f621e05eSBarry Smith      These are used internally in the PETSc routines to keep a count of MPI messages and
373f621e05eSBarry Smith    their sizes.
374f621e05eSBarry Smith 
375af0996ceSBarry Smith      This does not work for MPI-Uni because our include/petsc/mpiuni/mpi.h file
376ce85283eSBarry Smith    uses macros to defined the MPI operations.
37715308354SBarry Smith 
37815308354SBarry Smith      It does not work correctly from HP-UX because it processes the
379bb4af37aSBarry Smith    macros in a way that sometimes it double counts, hence
380b6410449SSatish Balay    PETSC_HAVE_BROKEN_RECURSIVE_MACRO
3817c1e34a4SSatish Balay 
382f569fd43SBarry Smith      It does not work with Windows because winmpich lacks MPI_Type_size()
383ce85283eSBarry Smith */
384c9b973beSBarry Smith #if !defined(MPIUNI_H) && !defined(PETSC_HAVE_BROKEN_RECURSIVE_MACRO) && !defined(PETSC_HAVE_MPI_MISSING_TYPESIZE)
38577a39924SBarry Smith /*
38677a39924SBarry Smith    Logging of MPI activities
38777a39924SBarry Smith */
3889371c9d4SSatish Balay static inline PetscErrorCode PetscMPITypeSize(PetscInt count, MPI_Datatype type, PetscLogDouble *length) {
389f12d10ccSJunchao Zhang   PetscMPIInt typesize;
3905f80ce2aSJacob Faibussowitsch 
3917d30fa4aSBarry Smith   if (type == MPI_DATATYPE_NULL) return 0;
3929566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Type_size(type, &typesize));
393f12d10ccSJunchao Zhang   *length += (PetscLogDouble)(count * typesize);
3949c72ff1eSSatish Balay   return 0;
395f95db71bSBarry Smith }
39677a39924SBarry Smith 
3979371c9d4SSatish Balay static inline PetscErrorCode PetscMPITypeSizeComm(MPI_Comm comm, const PetscMPIInt *counts, MPI_Datatype type, PetscLogDouble *length) {
398f12d10ccSJunchao Zhang   PetscMPIInt typesize, size, p;
3993b9284c0SMatthew G Knepley 
4007d30fa4aSBarry Smith   if (type == MPI_DATATYPE_NULL) return 0;
4019566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_size(comm, &size));
4029566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Type_size(type, &typesize));
4035f80ce2aSJacob Faibussowitsch   for (p = 0; p < size; ++p) *length += (PetscLogDouble)(counts[p] * typesize);
404f12d10ccSJunchao Zhang   return 0;
405f12d10ccSJunchao Zhang }
406f12d10ccSJunchao Zhang 
4079371c9d4SSatish Balay static inline PetscErrorCode PetscMPITypeSizeCount(PetscInt n, const PetscMPIInt *counts, MPI_Datatype type, PetscLogDouble *length) {
408f12d10ccSJunchao Zhang   PetscMPIInt typesize, p;
409f12d10ccSJunchao Zhang 
410f12d10ccSJunchao Zhang   if (type == MPI_DATATYPE_NULL) return 0;
4119566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Type_size(type, &typesize));
4125f80ce2aSJacob Faibussowitsch   for (p = 0; p < n; ++p) *length += (PetscLogDouble)(counts[p] * typesize);
4133b9284c0SMatthew G Knepley   return 0;
4143b9284c0SMatthew G Knepley }
4153b9284c0SMatthew G Knepley 
41672b11a25SBarry Smith /*
41772b11a25SBarry Smith     Returns 1 if the communicator is parallel else zero
41872b11a25SBarry Smith */
4199371c9d4SSatish Balay static inline int PetscMPIParallelComm(MPI_Comm comm) {
4209371c9d4SSatish Balay   PetscMPIInt size;
4219371c9d4SSatish Balay   MPI_Comm_size(comm, &size);
4229371c9d4SSatish Balay   return size > 1;
42372b11a25SBarry Smith }
42472b11a25SBarry Smith 
4259371c9d4SSatish Balay #define MPI_Irecv(buf, count, datatype, source, tag, comm, request) ((petsc_irecv_ct++, 0) || PetscMPITypeSize((count), (datatype), &(petsc_irecv_len)) || MPI_Irecv((buf), (count), (datatype), (source), (tag), (comm), (request)))
42615308354SBarry Smith 
4279371c9d4SSatish Balay #define MPI_Irecv_c(buf, count, datatype, source, tag, comm, request) ((petsc_irecv_ct++, 0) || PetscMPITypeSize((count), (datatype), &(petsc_irecv_len)) || MPI_Irecv_c((buf), (count), (datatype), (source), (tag), (comm), (request)))
428c87b50c4SJunchao Zhang 
4299371c9d4SSatish Balay #define MPI_Isend(buf, count, datatype, dest, tag, comm, request) ((petsc_isend_ct++, 0) || PetscMPITypeSize((count), (datatype), &(petsc_isend_len)) || MPI_Isend((buf), (count), (datatype), (dest), (tag), (comm), (request)))
43015308354SBarry Smith 
4319371c9d4SSatish Balay #define MPI_Isend_c(buf, count, datatype, dest, tag, comm, request) ((petsc_isend_ct++, 0) || PetscMPITypeSize((count), (datatype), &(petsc_isend_len)) || MPI_Isend_c((buf), (count), (datatype), (dest), (tag), (comm), (request)))
432c87b50c4SJunchao Zhang 
4339371c9d4SSatish Balay #define MPI_Startall_irecv(count, datatype, number, requests) ((petsc_irecv_ct += (PetscLogDouble)(number), 0) || PetscMPITypeSize((count), (datatype), &(petsc_irecv_len)) || ((number) && MPI_Startall((number), (requests))))
4340d4b0b6cSBarry Smith 
4359371c9d4SSatish Balay #define MPI_Startall_isend(count, datatype, number, requests) ((petsc_isend_ct += (PetscLogDouble)(number), 0) || PetscMPITypeSize((count), (datatype), &(petsc_isend_len)) || ((number) && MPI_Startall((number), (requests))))
4360d4b0b6cSBarry Smith 
4379371c9d4SSatish Balay #define MPI_Start_isend(count, datatype, requests) ((petsc_isend_ct++, 0) || PetscMPITypeSize((count), (datatype), (&petsc_isend_len)) || MPI_Start((requests)))
4380d4b0b6cSBarry Smith 
4399371c9d4SSatish Balay #define MPI_Recv(buf, count, datatype, source, tag, comm, status) ((petsc_recv_ct++, 0) || PetscMPITypeSize((count), (datatype), (&petsc_recv_len)) || MPI_Recv((buf), (count), (datatype), (source), (tag), (comm), (status)))
44015308354SBarry Smith 
4419371c9d4SSatish Balay #define MPI_Recv_c(buf, count, datatype, source, tag, comm, status) ((petsc_recv_ct++, 0) || PetscMPITypeSize((count), (datatype), (&petsc_recv_len)) || MPI_Recv_c((buf), (count), (datatype), (source), (tag), (comm), (status)))
442c87b50c4SJunchao Zhang 
4439371c9d4SSatish Balay #define MPI_Send(buf, count, datatype, dest, tag, comm) ((petsc_send_ct++, 0) || PetscMPITypeSize((count), (datatype), (&petsc_send_len)) || MPI_Send((buf), (count), (datatype), (dest), (tag), (comm)))
44477a39924SBarry Smith 
4459371c9d4SSatish Balay #define MPI_Send_c(buf, count, datatype, dest, tag, comm) ((petsc_send_ct++, 0) || PetscMPITypeSize((count), (datatype), (&petsc_send_len)) || MPI_Send_c((buf), (count), (datatype), (dest), (tag), (comm)))
446c87b50c4SJunchao Zhang 
4479371c9d4SSatish Balay #define MPI_Wait(request, status) ((petsc_wait_ct++, petsc_sum_of_waits_ct++, 0) || MPI_Wait((request), (status)))
44877a39924SBarry Smith 
4499371c9d4SSatish Balay #define MPI_Waitany(a, b, c, d) ((petsc_wait_any_ct++, petsc_sum_of_waits_ct++, 0) || MPI_Waitany((a), (b), (c), (d)))
45077a39924SBarry Smith 
4519371c9d4SSatish Balay #define MPI_Waitall(count, array_of_requests, array_of_statuses) ((petsc_wait_all_ct++, petsc_sum_of_waits_ct += (PetscLogDouble)(count), 0) || MPI_Waitall((count), (array_of_requests), (array_of_statuses)))
45277a39924SBarry Smith 
4539371c9d4SSatish Balay #define MPI_Allreduce(sendbuf, recvbuf, count, datatype, op, comm) (petsc_allreduce_ct += PetscMPIParallelComm((comm)), MPI_Allreduce((sendbuf), (recvbuf), (count), (datatype), (op), (comm)))
4543914022bSBarry Smith 
4559371c9d4SSatish Balay #define MPI_Bcast(buffer, count, datatype, root, comm) ((petsc_allreduce_ct += PetscMPIParallelComm((comm)), 0) || MPI_Bcast((buffer), (count), (datatype), (root), (comm)))
45654fe5c21SBarry Smith 
4579371c9d4SSatish Balay #define MPI_Reduce_scatter_block(sendbuf, recvbuf, recvcount, datatype, op, comm) ((petsc_allreduce_ct += PetscMPIParallelComm((comm)), 0) || MPI_Reduce_scatter_block((sendbuf), (recvbuf), (recvcount), (datatype), (op), (comm)))
458d6e4c47cSJed Brown 
4593b9284c0SMatthew G Knepley #define MPI_Alltoall(sendbuf, sendcount, sendtype, recvbuf, recvcount, recvtype, comm) \
460f12d10ccSJunchao Zhang   ((petsc_allreduce_ct += PetscMPIParallelComm((comm)), 0) || PetscMPITypeSize((sendcount), (sendtype), (&petsc_send_len)) || MPI_Alltoall((sendbuf), (sendcount), (sendtype), (recvbuf), (recvcount), (recvtype), (comm)))
4613b9284c0SMatthew G Knepley 
4623b9284c0SMatthew G Knepley #define MPI_Alltoallv(sendbuf, sendcnts, sdispls, sendtype, recvbuf, recvcnts, rdispls, recvtype, comm) \
463f12d10ccSJunchao Zhang   ((petsc_allreduce_ct += PetscMPIParallelComm((comm)), 0) || PetscMPITypeSizeComm((comm), (sendcnts), (sendtype), (&petsc_send_len)) || MPI_Alltoallv((sendbuf), (sendcnts), (sdispls), (sendtype), (recvbuf), (recvcnts), (rdispls), (recvtype), (comm)))
4643b9284c0SMatthew G Knepley 
4659371c9d4SSatish Balay #define MPI_Allgather(sendbuf, sendcount, sendtype, recvbuf, recvcount, recvtype, comm) ((petsc_gather_ct += PetscMPIParallelComm((comm)), 0) || MPI_Allgather((sendbuf), (sendcount), (sendtype), (recvbuf), (recvcount), (recvtype), (comm)))
46601faf4e4SMatthew Knepley 
46701faf4e4SMatthew Knepley #define MPI_Allgatherv(sendbuf, sendcount, sendtype, recvbuf, recvcount, displs, recvtype, comm) \
4685fa69175SJed Brown   ((petsc_gather_ct += PetscMPIParallelComm((comm)), 0) || MPI_Allgatherv((sendbuf), (sendcount), (sendtype), (recvbuf), (recvcount), (displs), (recvtype), (comm)))
46901faf4e4SMatthew Knepley 
47001faf4e4SMatthew Knepley #define MPI_Gather(sendbuf, sendcount, sendtype, recvbuf, recvcount, recvtype, root, comm) \
471f12d10ccSJunchao Zhang   ((petsc_gather_ct++, 0) || PetscMPITypeSize((sendcount), (sendtype), (&petsc_send_len)) || MPI_Gather((sendbuf), (sendcount), (sendtype), (recvbuf), (recvcount), (recvtype), (root), (comm)))
47201faf4e4SMatthew Knepley 
47301faf4e4SMatthew Knepley #define MPI_Gatherv(sendbuf, sendcount, sendtype, recvbuf, recvcount, displs, recvtype, root, comm) \
474f12d10ccSJunchao Zhang   ((petsc_gather_ct++, 0) || PetscMPITypeSize((sendcount), (sendtype), (&petsc_send_len)) || MPI_Gatherv((sendbuf), (sendcount), (sendtype), (recvbuf), (recvcount), (displs), (recvtype), (root), (comm)))
47501faf4e4SMatthew Knepley 
47601faf4e4SMatthew Knepley #define MPI_Scatter(sendbuf, sendcount, sendtype, recvbuf, recvcount, recvtype, root, comm) \
477f12d10ccSJunchao Zhang   ((petsc_scatter_ct++, 0) || PetscMPITypeSize((recvcount), (recvtype), (&petsc_recv_len)) || MPI_Scatter((sendbuf), (sendcount), (sendtype), (recvbuf), (recvcount), (recvtype), (root), (comm)))
47801faf4e4SMatthew Knepley 
47901faf4e4SMatthew Knepley #define MPI_Scatterv(sendbuf, sendcount, displs, sendtype, recvbuf, recvcount, recvtype, root, comm) \
480f12d10ccSJunchao Zhang   ((petsc_scatter_ct++, 0) || PetscMPITypeSize((recvcount), (recvtype), (&petsc_recv_len)) || MPI_Scatterv((sendbuf), (sendcount), (displs), (sendtype), (recvbuf), (recvcount), (recvtype), (root), (comm)))
481f12d10ccSJunchao Zhang 
482f12d10ccSJunchao Zhang #define MPI_Ialltoall(sendbuf, sendcount, sendtype, recvbuf, recvcount, recvtype, comm, request) \
483f12d10ccSJunchao Zhang   ((petsc_allreduce_ct += PetscMPIParallelComm((comm)), 0) || PetscMPITypeSize((sendcount), (sendtype), (&petsc_send_len)) || MPI_Ialltoall((sendbuf), (sendcount), (sendtype), (recvbuf), (recvcount), (recvtype), (comm), (request)))
484f12d10ccSJunchao Zhang 
485f12d10ccSJunchao Zhang #define MPI_Ialltoallv(sendbuf, sendcnts, sdispls, sendtype, recvbuf, recvcnts, rdispls, recvtype, comm, request) \
486f12d10ccSJunchao Zhang   ((petsc_allreduce_ct += PetscMPIParallelComm((comm)), 0) || PetscMPITypeSizeComm((comm), (sendcnts), (sendtype), (&petsc_send_len)) || MPI_Ialltoallv((sendbuf), (sendcnts), (sdispls), (sendtype), (recvbuf), (recvcnts), (rdispls), (recvtype), (comm), (request)))
487f12d10ccSJunchao Zhang 
488f12d10ccSJunchao Zhang #define MPI_Iallgather(sendbuf, sendcount, sendtype, recvbuf, recvcount, recvtype, comm, request) \
489f12d10ccSJunchao Zhang   ((petsc_gather_ct += PetscMPIParallelComm((comm)), 0) || MPI_Iallgather((sendbuf), (sendcount), (sendtype), (recvbuf), (recvcount), (recvtype), (comm), (request)))
490f12d10ccSJunchao Zhang 
491f12d10ccSJunchao Zhang #define MPI_Iallgatherv(sendbuf, sendcount, sendtype, recvbuf, recvcount, displs, recvtype, comm, request) \
492f12d10ccSJunchao Zhang   ((petsc_gather_ct += PetscMPIParallelComm((comm)), 0) || MPI_Iallgatherv((sendbuf), (sendcount), (sendtype), (recvbuf), (recvcount), (displs), (recvtype), (comm), (request)))
493f12d10ccSJunchao Zhang 
494f12d10ccSJunchao Zhang #define MPI_Igather(sendbuf, sendcount, sendtype, recvbuf, recvcount, recvtype, root, comm, request) \
495f12d10ccSJunchao Zhang   ((petsc_gather_ct++, 0) || PetscMPITypeSize((sendcount), (sendtype), (&petsc_send_len)) || MPI_Igather((sendbuf), (sendcount), (sendtype), (recvbuf), (recvcount), (recvtype), (root), (comm), (request)))
496f12d10ccSJunchao Zhang 
497f12d10ccSJunchao Zhang #define MPI_Igatherv(sendbuf, sendcount, sendtype, recvbuf, recvcount, displs, recvtype, root, comm, request) \
498f12d10ccSJunchao Zhang   ((petsc_gather_ct++, 0) || PetscMPITypeSize((sendcount), (sendtype), (&petsc_send_len)) || MPI_Igatherv((sendbuf), (sendcount), (sendtype), (recvbuf), (recvcount), (displs), (recvtype), (root), (comm), (request)))
499f12d10ccSJunchao Zhang 
500f12d10ccSJunchao Zhang #define MPI_Iscatter(sendbuf, sendcount, sendtype, recvbuf, recvcount, recvtype, root, comm, request) \
501f12d10ccSJunchao Zhang   ((petsc_scatter_ct++, 0) || PetscMPITypeSize((recvcount), (recvtype), (&petsc_recv_len)) || MPI_Iscatter((sendbuf), (sendcount), (sendtype), (recvbuf), (recvcount), (recvtype), (root), (comm), (request)))
502f12d10ccSJunchao Zhang 
503f12d10ccSJunchao Zhang #define MPI_Iscatterv(sendbuf, sendcount, displs, sendtype, recvbuf, recvcount, recvtype, root, comm, request) \
504f12d10ccSJunchao Zhang   ((petsc_scatter_ct++, 0) || PetscMPITypeSize((recvcount), (recvtype), (&petsc_recv_len)) || MPI_Iscatterv((sendbuf), (sendcount), (displs), (sendtype), (recvbuf), (recvcount), (recvtype), (root), (comm), (request)))
505f12d10ccSJunchao Zhang 
5060d4b0b6cSBarry Smith #else
5070d4b0b6cSBarry Smith 
5089371c9d4SSatish Balay #define MPI_Startall_irecv(count, datatype, number, requests) ((number) && MPI_Startall((number), (requests)))
5090d4b0b6cSBarry Smith 
5109371c9d4SSatish Balay #define MPI_Startall_isend(count, datatype, number, requests) ((number) && MPI_Startall((number), (requests)))
5110d4b0b6cSBarry Smith 
5129371c9d4SSatish Balay #define MPI_Start_isend(count, datatype, requests) (MPI_Start((requests)))
5130d4b0b6cSBarry Smith 
514c9b973beSBarry Smith #endif /* !MPIUNI_H && ! PETSC_HAVE_BROKEN_RECURSIVE_MACRO */
515614700edSBarry Smith 
516df8cf0b5SBarry Smith #else /* ---Logging is turned off --------------------------------------------*/
517614700edSBarry Smith 
518e3ed9ee7SBarry Smith #define PetscLogMemory PETSC_FALSE
519e3ed9ee7SBarry Smith 
520b0a32e0cSBarry Smith #define PetscLogFlops(n) 0
521fa2bb9feSLisandro Dalcin #define PetscGetFlops(a) (*(a) = 0.0, 0)
522614700edSBarry Smith 
523fa2bb9feSLisandro Dalcin #define PetscLogStageRegister(a, b)   0
524fa2bb9feSLisandro Dalcin #define PetscLogStagePush(a)          0
525fa2bb9feSLisandro Dalcin #define PetscLogStagePop()            0
526f5d6ab90SLisandro Dalcin #define PetscLogStageSetActive(a, b)  0
527f5d6ab90SLisandro Dalcin #define PetscLogStageGetActive(a, b)  0
528f5d6ab90SLisandro Dalcin #define PetscLogStageGetVisible(a, b) 0
529f5d6ab90SLisandro Dalcin #define PetscLogStageSetVisible(a, b) 0
530f5d6ab90SLisandro Dalcin #define PetscLogStageGetId(a, b)      (*(b) = 0, 0)
531f5d6ab90SLisandro Dalcin 
532fa2bb9feSLisandro Dalcin #define PetscLogEventRegister(a, b, c)    0
533fa2bb9feSLisandro Dalcin #define PetscLogEventSetCollective(a, b)  0
534fa2bb9feSLisandro Dalcin #define PetscLogEventIncludeClass(a)      0
535fa2bb9feSLisandro Dalcin #define PetscLogEventExcludeClass(a)      0
536b0a32e0cSBarry Smith #define PetscLogEventActivate(a)          0
537b0a32e0cSBarry Smith #define PetscLogEventDeactivate(a)        0
538c00cb57fSBarry Smith #define PetscLogEventDeactivatePush(a)    0
539c00cb57fSBarry Smith #define PetscLogEventDeactivatePop(a)     0
540b0a32e0cSBarry Smith #define PetscLogEventActivateClass(a)     0
541b0a32e0cSBarry Smith #define PetscLogEventDeactivateClass(a)   0
542e8e7597cSSatish Balay #define PetscLogEventSetActiveAll(a, b)   0
54346eb3cd7SSatish Balay #define PetscLogEventGetId(a, b)          (*(b) = 0, 0)
544561b2a67SSatish Balay #define PetscLogEventGetPerfInfo(a, b, c) 0
5459c702cfcSMatthew G. Knepley #define PetscLogEventSetDof(a, b, c)      0
5469c702cfcSMatthew G. Knepley #define PetscLogEventSetError(a, b, c)    0
54777c4ece6SBarry Smith 
5488b5db460SBarry Smith #define PetscLogPLB 0
5498b5db460SBarry Smith #define PetscLogPLE 0
5508b5db460SBarry Smith #define PetscLogPHC 0
5518b5db460SBarry Smith #define PetscLogPHD 0
552f5d6ab90SLisandro Dalcin 
553efee365bSSatish Balay #define PetscLogObjectParents(p, n, c) 0
55452e6d16bSBarry Smith #define PetscLogObjectCreate(h)        0
55552e6d16bSBarry Smith #define PetscLogObjectDestroy(h)       0
5563ca90d2dSJacob Faibussowitsch PETSC_EXTERN PetscErrorCode PetscLogObjectState(PetscObject, const char[], ...) PETSC_ATTRIBUTE_FORMAT(2, 3);
557fa2bb9feSLisandro Dalcin 
558bb1d7374SBarry Smith #define PetscLogDefaultBegin()     0
559b0a32e0cSBarry Smith #define PetscLogAllBegin()         0
560bb1d7374SBarry Smith #define PetscLogNestedBegin()      0
561fa2bb9feSLisandro Dalcin #define PetscLogTraceBegin(file)   0
56273fda44aSBarry Smith #define PetscLogActions(a)         0
563fa2bb9feSLisandro Dalcin #define PetscLogObjects(a)         0
564fa2bb9feSLisandro Dalcin #define PetscLogSetThreshold(a, b) 0
565fa2bb9feSLisandro Dalcin #define PetscLogSet(lb, le)        0
566340002ceSLawrence Mitchell #define PetscLogIsActive(flag)     (*(flag) = PETSC_FALSE, 0)
567fa2bb9feSLisandro Dalcin 
568fa2bb9feSLisandro Dalcin #define PetscLogView(viewer)      0
569fa2bb9feSLisandro Dalcin #define PetscLogViewFromOptions() 0
570fa2bb9feSLisandro Dalcin #define PetscLogDump(c)           0
571fa2bb9feSLisandro Dalcin 
57262872c28SLisandro Dalcin #define PetscLogEventSync(e, comm)                            0
573fa2bb9feSLisandro Dalcin #define PetscLogEventBegin(e, o1, o2, o3, o4)                 0
574fa2bb9feSLisandro Dalcin #define PetscLogEventEnd(e, o1, o2, o3, o4)                   0
575ce6058e1SBarry Smith 
57623c86b1bSSatish Balay /* If PETSC_USE_LOG is NOT defined, these still need to be! */
57723c86b1bSSatish Balay #define MPI_Startall_irecv(count, datatype, number, requests) ((number) && MPI_Startall(number, requests))
57823c86b1bSSatish Balay #define MPI_Startall_isend(count, datatype, number, requests) ((number) && MPI_Startall(number, requests))
57923c86b1bSSatish Balay #define MPI_Start_isend(count, datatype, requests)            MPI_Start(requests)
58023c86b1bSSatish Balay 
58123c86b1bSSatish Balay #endif /* PETSC_USE_LOG */
58223c86b1bSSatish Balay 
58323c86b1bSSatish Balay #if defined(PETSC_USE_LOG) && defined(PETSC_HAVE_DEVICE)
58423c86b1bSSatish Balay 
58523c86b1bSSatish Balay /* Global GPU counters */
58623c86b1bSSatish Balay PETSC_EXTERN PetscLogDouble petsc_ctog_ct;
58723c86b1bSSatish Balay PETSC_EXTERN PetscLogDouble petsc_gtoc_ct;
58823c86b1bSSatish Balay PETSC_EXTERN PetscLogDouble petsc_ctog_sz;
58923c86b1bSSatish Balay PETSC_EXTERN PetscLogDouble petsc_gtoc_sz;
59023c86b1bSSatish Balay PETSC_EXTERN PetscLogDouble petsc_ctog_ct_scalar;
59123c86b1bSSatish Balay PETSC_EXTERN PetscLogDouble petsc_gtoc_ct_scalar;
59223c86b1bSSatish Balay PETSC_EXTERN PetscLogDouble petsc_ctog_sz_scalar;
59323c86b1bSSatish Balay PETSC_EXTERN PetscLogDouble petsc_gtoc_sz_scalar;
59423c86b1bSSatish Balay PETSC_EXTERN PetscLogDouble petsc_gflops;
59523c86b1bSSatish Balay PETSC_EXTERN PetscLogDouble petsc_gtime;
59623c86b1bSSatish Balay 
5979371c9d4SSatish Balay static inline PetscErrorCode PetscLogCpuToGpu(PetscLogDouble size) {
59823c86b1bSSatish Balay   PetscFunctionBegin;
59923c86b1bSSatish Balay   petsc_ctog_ct += 1;
60023c86b1bSSatish Balay   petsc_ctog_sz += size;
60123c86b1bSSatish Balay   PetscFunctionReturn(0);
60223c86b1bSSatish Balay }
60323c86b1bSSatish Balay 
6049371c9d4SSatish Balay static inline PetscErrorCode PetscLogGpuToCpu(PetscLogDouble size) {
60523c86b1bSSatish Balay   PetscFunctionBegin;
60623c86b1bSSatish Balay   petsc_gtoc_ct += 1;
60723c86b1bSSatish Balay   petsc_gtoc_sz += size;
60823c86b1bSSatish Balay   PetscFunctionReturn(0);
60923c86b1bSSatish Balay }
61023c86b1bSSatish Balay 
6119371c9d4SSatish Balay static inline PetscErrorCode PetscLogCpuToGpuScalar(PetscLogDouble size) {
61223c86b1bSSatish Balay   PetscFunctionBegin;
61323c86b1bSSatish Balay   petsc_ctog_ct_scalar += 1;
61423c86b1bSSatish Balay   petsc_ctog_sz_scalar += size;
61523c86b1bSSatish Balay   PetscFunctionReturn(0);
61623c86b1bSSatish Balay }
61723c86b1bSSatish Balay 
6189371c9d4SSatish Balay static inline PetscErrorCode PetscLogGpuToCpuScalar(PetscLogDouble size) {
61923c86b1bSSatish Balay   PetscFunctionBegin;
62023c86b1bSSatish Balay   petsc_gtoc_ct_scalar += 1;
62123c86b1bSSatish Balay   petsc_gtoc_sz_scalar += size;
62223c86b1bSSatish Balay   PetscFunctionReturn(0);
62323c86b1bSSatish Balay }
62423c86b1bSSatish Balay 
62523c86b1bSSatish Balay /*@C
62623c86b1bSSatish Balay        PetscLogGpuFlops - Log how many flops are performed in a calculation on the device
62723c86b1bSSatish Balay 
62823c86b1bSSatish Balay    Input Parameter:
62923c86b1bSSatish Balay .   flops - the number of flops
63023c86b1bSSatish Balay 
63123c86b1bSSatish Balay    Notes:
63223c86b1bSSatish Balay      To limit the chance of integer overflow when multiplying by a constant, represent the constant as a double,
63323c86b1bSSatish Balay      not an integer. Use PetscLogFlops(4.0*n) not PetscLogFlops(4*n)
63423c86b1bSSatish Balay 
6354851f57dSBarry Smith      The values are also added to the total flop count for the MPI rank that is set with `PetscLogFlops()`; hence the number of flops
6364851f57dSBarry Smith      just on the CPU would be the value from set from `PetscLogFlops()` minus the value set from `PetscLogGpuFlops()`
6374851f57dSBarry Smith 
63823c86b1bSSatish Balay    Level: intermediate
63923c86b1bSSatish Balay 
640db781477SPatrick Sanan .seealso: `PetscLogView()`, `PetscLogFlops()`, `PetscLogGpuTimeBegin()`, `PetscLogGpuTimeEnd()`
64123c86b1bSSatish Balay @*/
6429371c9d4SSatish Balay static inline PetscErrorCode PetscLogGpuFlops(PetscLogDouble n) {
64323c86b1bSSatish Balay   PetscFunctionBegin;
6442c71b3e2SJacob Faibussowitsch   PetscCheck(n >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Cannot log negative flops");
64523c86b1bSSatish Balay   petsc_TotalFlops += PETSC_FLOPS_PER_OP * n;
64623c86b1bSSatish Balay   petsc_gflops += PETSC_FLOPS_PER_OP * n;
64723c86b1bSSatish Balay   PetscFunctionReturn(0);
64823c86b1bSSatish Balay }
64923c86b1bSSatish Balay 
6509371c9d4SSatish Balay static inline PetscErrorCode PetscLogGpuTimeAdd(PetscLogDouble t) {
65123c86b1bSSatish Balay   PetscFunctionBegin;
65223c86b1bSSatish Balay   petsc_gtime += t;
65323c86b1bSSatish Balay   PetscFunctionReturn(0);
65423c86b1bSSatish Balay }
65523c86b1bSSatish Balay 
656156b51fbSBarry Smith PETSC_EXTERN PetscErrorCode PetscLogGpuTime(void);
65723c86b1bSSatish Balay PETSC_EXTERN PetscErrorCode PetscLogGpuTimeBegin(void);
65823c86b1bSSatish Balay PETSC_EXTERN PetscErrorCode PetscLogGpuTimeEnd(void);
65923c86b1bSSatish Balay 
66023c86b1bSSatish Balay #else
66123c86b1bSSatish Balay 
6628157aad8SJunchao Zhang #define PetscLogCpuToGpu(a)       0
6638157aad8SJunchao Zhang #define PetscLogGpuToCpu(a)       0
66445c4b7c1SBarry Smith #define PetscLogCpuToGpuScalar(a) 0
66545c4b7c1SBarry Smith #define PetscLogGpuToCpuScalar(a) 0
6668157aad8SJunchao Zhang #define PetscLogGpuFlops(a)       0
6677a101e5eSJacob Faibussowitsch #define PetscLogGpuTime()         0
66853b96e71SJacob Faibussowitsch #define PetscLogGpuTimeAdd(a)     0
6698157aad8SJunchao Zhang #define PetscLogGpuTimeBegin()    0
6708157aad8SJunchao Zhang #define PetscLogGpuTimeEnd()      0
6718157aad8SJunchao Zhang 
67223c86b1bSSatish Balay #endif /* PETSC_USE_LOG && PETSC_HAVE_DEVICE */
6736daaf66cSBarry Smith 
674204a6943SJed Brown #define PetscPreLoadBegin(flag, name) \
675204a6943SJed Brown   do { \
676204a6943SJed Brown     PetscBool     PetscPreLoading = flag; \
677204a6943SJed Brown     int           PetscPreLoadMax, PetscPreLoadIt; \
678166c7f25SBarry Smith     PetscLogStage _stageNum; \
6799566063dSJacob Faibussowitsch     PetscCall(PetscOptionsGetBool(NULL, NULL, "-preload", &PetscPreLoading, NULL)); \
680204a6943SJed Brown     PetscPreLoadMax     = (int)(PetscPreLoading); \
681204a6943SJed Brown     PetscPreLoadingUsed = PetscPreLoading ? PETSC_TRUE : PetscPreLoadingUsed; \
682204a6943SJed Brown     for (PetscPreLoadIt = 0; PetscPreLoadIt <= PetscPreLoadMax; PetscPreLoadIt++) { \
683204a6943SJed Brown       PetscPreLoadingOn = PetscPreLoading; \
6849566063dSJacob Faibussowitsch       PetscCall(PetscBarrier(NULL)); \
6859566063dSJacob Faibussowitsch       if (PetscPreLoadIt > 0) PetscCall(PetscLogStageGetId(name, &_stageNum)); \
6869566063dSJacob Faibussowitsch       else PetscCall(PetscLogStageRegister(name, &_stageNum)); \
6879566063dSJacob Faibussowitsch       PetscCall(PetscLogStageSetActive(_stageNum, (PetscBool)(!PetscPreLoadMax || PetscPreLoadIt))); \
6889566063dSJacob Faibussowitsch       PetscCall(PetscLogStagePush(_stageNum));
6898e58c17dSMatthew Knepley 
690204a6943SJed Brown #define PetscPreLoadEnd() \
6919566063dSJacob Faibussowitsch   PetscCall(PetscLogStagePop()); \
692204a6943SJed Brown   PetscPreLoading = PETSC_FALSE; \
693043328b6SSatish Balay   } \
6949371c9d4SSatish Balay   } \
6959371c9d4SSatish Balay   while (0)
6968e58c17dSMatthew Knepley 
6979371c9d4SSatish Balay #define PetscPreLoadStage(name) \
6989371c9d4SSatish Balay   do { \
6999566063dSJacob Faibussowitsch     PetscCall(PetscLogStagePop()); \
7009566063dSJacob Faibussowitsch     if (PetscPreLoadIt > 0) PetscCall(PetscLogStageGetId(name, &_stageNum)); \
7019566063dSJacob Faibussowitsch     else PetscCall(PetscLogStageRegister(name, &_stageNum)); \
7029566063dSJacob Faibussowitsch     PetscCall(PetscLogStageSetActive(_stageNum, (PetscBool)(!PetscPreLoadMax || PetscPreLoadIt))); \
7039566063dSJacob Faibussowitsch     PetscCall(PetscLogStagePush(_stageNum)); \
704204a6943SJed Brown   } while (0)
705e9fa29b7SSatish Balay 
706ad14c47eSJed Brown /* some vars for logging */
707ad14c47eSJed Brown PETSC_EXTERN PetscBool PetscPreLoadingUsed; /* true if we are or have done preloading */
708ad14c47eSJed Brown PETSC_EXTERN PetscBool PetscPreLoadingOn;   /* true if we are currently in a preloading calculation */
709ad14c47eSJed Brown 
71097bb86f7SLois Curfman McInnes #endif
711