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
|
#ifndef __SGE_SERF_H
#define __SGE_SERF_H
/*___INFO__MARK_BEGIN__*/
/*************************************************************************
*
* The Contents of this file are made available subject to the terms of
* the Sun Industry Standards Source License Version 1.2
*
* Sun Microsystems Inc., March, 2001
*
*
* Sun Industry Standards Source License Version 1.2
* =================================================
* The contents of this file are subject to the Sun Industry Standards
* Source License Version 1.2 (the "License"); You may not use this file
* except in compliance with the License. You may obtain a copy of the
* License at http://gridengine.sunsource.net/Gridengine_SISSL_license.html
*
* Software provided under this License is provided on an "AS IS" basis,
* WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,
* WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS,
* MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING.
* See the License for the specific provisions governing your rights and
* obligations concerning the Software.
*
* The Initial Developer of the Original Code is: Sun Microsystems, Inc.
*
* Copyright: 2001 by Sun Microsystems, Inc.
*
* All Rights Reserved.
*
************************************************************************/
/*___INFO__MARK_END__*/
/****** SERF/-SERF_Interface *******************************************************
* NAME
* SERF -- Schedule entry recording facility
*
* FUNCTION
* The enlisted functions below allow for plugging in any module that
* records schedule entries be used that registers through sge_serf_init()
* the following methods:
*
* typedef void (*record_schedule_entry_func_t)(
* u_long32 job_id,
* u_long32 ja_taskid,
* const char *state,
* u_long32 start_time,
* u_long32 end_time,
* char level_char,
* const char *object_name,
* const char *name,
* double utilization);
*
* typedef void (*new_schedule_func_t)(u_long32 time);
*
* SEE ALSO
* SERF/serf_init()
* SERF/serf_record_entry()
* SERF/serf_new_interval()
* SERF/serf_get_active()
* SERF/serf_set_active()
* SERF/serf_exit()
*******************************************************************************/
#define SCHEDULING_RECORD_ENTRY_TYPE_RUNNING "RUNNING"
#define SCHEDULING_RECORD_ENTRY_TYPE_SUSPENDED "SUSPENDED"
#define SCHEDULING_RECORD_ENTRY_TYPE_PREEMPTING "MIGRATING" /* currently unused */
#define SCHEDULING_RECORD_ENTRY_TYPE_STARTING "STARTING"
#define SCHEDULING_RECORD_ENTRY_TYPE_RESERVING "RESERVING"
typedef void (*record_schedule_entry_func_t)(u_long32 job_id, u_long32 ja_taskid,
const char *state, u_long32 start_time, u_long32 end_time, char level_char,
const char *object_name, const char *name, double utilization);
typedef void (*new_schedule_func_t)(u_long32 time);
void serf_init(record_schedule_entry_func_t, new_schedule_func_t);
void serf_record_entry(u_long32 job_id, u_long32 ja_taskid,
const char *state, u_long32 start_time, u_long32 end_time, char level_char,
const char *object_name, const char *name, double utilization);
void serf_new_interval(u_long32 time);
void serf_exit(void);
#endif /* __SGE_SERF_H */
|
