100 lines
3.8 KiB
C++
100 lines
3.8 KiB
C++
// -*- C++ -*-
|
|
|
|
/*
|
|
* @copyright
|
|
* Copyright (C) 2009-2013, Intel Corporation
|
|
* All rights reserved.
|
|
*
|
|
* @copyright
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
*
|
|
* * Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* * Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in
|
|
* the documentation and/or other materials provided with the
|
|
* distribution.
|
|
* * Neither the name of Intel Corporation nor the names of its
|
|
* contributors may be used to endorse or promote products derived
|
|
* from this software without specific prior written permission.
|
|
*
|
|
* @copyright
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
|
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
|
* HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
|
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
|
|
* OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
|
|
* AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY
|
|
* WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
******************************************************************************
|
|
*
|
|
* metacall.h
|
|
*
|
|
* This is an internal header file defining part of the metacall
|
|
* interface used by Cilkscreen. It is not a stable API and is
|
|
* subject to change without notice.
|
|
*/
|
|
|
|
// Provides the enum of metacall kinds. This is used by Cilkscreen and the
|
|
// runtime, and will probably be used by any future ptools.
|
|
|
|
#pragma once
|
|
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
|
|
enum
|
|
{
|
|
// Notify Cilkscreen to stop/start instrumenting code
|
|
HYPER_DISABLE_INSTRUMENTATION = 0,
|
|
HYPER_ENABLE_INSTRUMENTATION = 1,
|
|
|
|
// Write 0 in *(char *)arg if the p-tool is sequential. The Cilk runtime
|
|
// system invokes this metacall to know whether to spawn worker threads.
|
|
HYPER_ZERO_IF_SEQUENTIAL_PTOOL = 2,
|
|
|
|
// Write 0 in *(char *)arg if the runtime must force reducers to
|
|
// call the reduce() method even if no actual stealing occurs.
|
|
HYPER_ZERO_IF_FORCE_REDUCE = 3,
|
|
|
|
// Inform cilkscreen about the current stack pointer.
|
|
HYPER_ESTABLISH_C_STACK = 4,
|
|
|
|
// Inform Cilkscreen about the current worker
|
|
HYPER_ESTABLISH_WORKER = 5,
|
|
|
|
// Tell tools to ignore a block of memory. Parameter is a 2 element
|
|
// array: void *block[2] = {_begin, _end}; _end is 1 beyond the end
|
|
// of the block to be ignored. Essentially, if p is a pointer to an
|
|
// array, _begin = &p[0], _end = &p[max]
|
|
HYPER_IGNORE_MEMORY_BLOCK = 6
|
|
|
|
// If you add metacalls here, remember to update BOTH workspan.cpp AND
|
|
// cilkscreen-common.cpp!
|
|
};
|
|
|
|
typedef struct
|
|
{
|
|
unsigned int tool; // Specifies tool metacall is for
|
|
// (eg. system=0, cilkscreen=1, cilkview=2).
|
|
// All tools should understand system codes.
|
|
// Tools should ignore all other codes, except
|
|
// their own.
|
|
|
|
unsigned int code; // Tool-specific code specifies what to do and how to
|
|
// interpret data
|
|
|
|
void *data;
|
|
} metacall_data_t;
|
|
|
|
#define METACALL_TOOL_SYSTEM 0
|
|
|
|
///////////////////////////////////////////////////////////////////////////////
|