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 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475
|
/*
* Copyright (c) 2004-2010 The Trustees of Indiana University and Indiana
* University Research and Technology
* Corporation. All rights reserved.
* Copyright (c) 2004-2011 The University of Tennessee and The University
* of Tennessee Research Foundation. All rights
* reserved.
* Copyright (c) 2004-2005 High Performance Computing Center Stuttgart,
* University of Stuttgart. All rights reserved.
* Copyright (c) 2004-2005 The Regents of the University of California.
* All rights reserved.
* Copyright (c) 2006-2013 Los Alamos National Security, LLC.
* All rights reserved.
* Copyright (c) 2009-2020 Cisco Systems, Inc. All rights reserved
* Copyright (c) 2011 Oak Ridge National Labs. All rights reserved.
* Copyright (c) 2013-2020 Intel, Inc. All rights reserved.
* Copyright (c) 2015 Mellanox Technologies, Inc. All rights reserved.
* Copyright (c) 2021-2025 Nanook Consulting All rights reserved.
* Copyright (c) 2021 IBM Corporation. All rights reserved.
* $COPYRIGHT$
*
* Additional copyrights may follow
*
* $HEADER$
*
*/
#define _GNU_SOURCE
#include <getopt.h>
#include <libgen.h>
#include <pthread.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <time.h>
#include <unistd.h>
#include "debugger.h"
#include <pmix_tool.h>
static pmix_proc_t myproc;
static volatile bool ilactive = true;
static volatile bool dbactive = true;
static volatile char *appnspace = NULL;
static volatile bool regpending = true;
/* this is the event notification function we pass down below
* when registering for general events - i.e.,, the default
* handler. We don't technically need to register one, but it
* is usually good practice to catch any events that occur */
static void notification_fn(size_t evhdlr_registration_id, pmix_status_t status,
const pmix_proc_t *source, pmix_info_t info[], size_t ninfo,
pmix_info_t results[], size_t nresults,
pmix_event_notification_cbfunc_fn_t cbfunc, void *cbdata)
{
printf("DEFAULT EVENT HANDLER CALLED WITH STATUS %s\n", PMIx_Error_string(status));
/* this example doesn't do anything with default events */
if (NULL != cbfunc) {
cbfunc(PMIX_EVENT_ACTION_COMPLETE, NULL, 0, NULL, NULL, cbdata);
}
ilactive = false;
printf("\tCOMPLETE\n");
}
/* this is the event notification function we pass down below
* when registering for LOST_CONNECTION, thereby indicating
* that the intermediate launcher we started has terminated */
static void terminate_fn(size_t evhdlr_registration_id, pmix_status_t status,
const pmix_proc_t *source, pmix_info_t info[], size_t ninfo,
pmix_info_t results[], size_t nresults,
pmix_event_notification_cbfunc_fn_t cbfunc, void *cbdata)
{
printf("%s called with status %s\n", __FUNCTION__, PMIx_Error_string(status));
/* this example doesn't do anything further */
if (NULL != cbfunc) {
cbfunc(PMIX_EVENT_ACTION_COMPLETE, NULL, 0, NULL, NULL, cbdata);
}
ilactive = false;
}
/* event handler registration is done asynchronously because it
* may involve the PMIx server registering with the host RM for
* external events. So we provide a callback function that returns
* the status of the request (success or an error), plus a numerical index
* to the registered event. The index is used later on to deregister
* an event handler - if we don't explicitly deregister it, then the
* PMIx server will do so when it see us exit */
static void evhandler_reg_callbk(pmix_status_t status, size_t evhandler_ref, void *cbdata)
{
mylock_t *lock = (mylock_t *) cbdata;
printf("%s called with status %s\n", __FUNCTION__, PMIx_Error_string(status));
if (PMIX_SUCCESS != status) {
fprintf(stderr, "Client %s:%d EVENT HANDLER REGISTRATION FAILED WITH STATUS %d, ref=%lu\n",
myproc.nspace, myproc.rank, status, (unsigned long) evhandler_ref);
}
lock->status = status;
regpending = false;
DEBUG_WAKEUP_THREAD(lock);
}
static void opcbfunc(pmix_status_t status, void *cbdata)
{
mylock_t *lock = (mylock_t *) cbdata;
lock->status = status;
DEBUG_WAKEUP_THREAD(lock);
}
static void spawn_cbfunc(size_t evhdlr_registration_id, pmix_status_t status,
const pmix_proc_t *source, pmix_info_t info[], size_t ninfo,
pmix_info_t results[], size_t nresults,
pmix_event_notification_cbfunc_fn_t cbfunc, void *cbdata)
{
size_t n;
for (n = 0; n < ninfo; n++) {
if (PMIX_CHECK_KEY(&info[n], PMIX_NSPACE)) {
appnspace = strdup(info[n].value.data.string);
printf("GOT NSPACE %s\n", appnspace);
break;
}
}
printf("Debugger daemon job: %s\n", appnspace);
dbactive = false;
if (NULL != cbfunc) {
cbfunc(PMIX_EVENT_ACTION_COMPLETE, NULL, 0, NULL, NULL, cbdata);
}
}
#define DBGR_LOOP_LIMIT 10
int main(int argc, char **argv)
{
pmix_status_t rc;
pmix_info_t *info, iofinfo;
pmix_app_t *app;
size_t ninfo, napps;
char *requested_launcher;
int timeout;
size_t n;
char cwd[1024];
pmix_status_t code = PMIX_EVENT_JOB_END;
mylock_t mylock;
pid_t pid;
char *launchers[] = {"prun", "mpirun", "mpiexec", "prterun", NULL};
pmix_proc_t proc, target_proc;
bool found;
pmix_data_array_t darray, darray2;
pmix_nspace_t clientspace, dbnspace;
pmix_value_t *val;
char *myuri = NULL;
void *jinfo, *linfo, *dirs;
myquery_data_t *mydata = NULL;
pmix_rank_t rank;
/* need to provide args */
if (2 > argc) {
fprintf(stderr, "Usage: %s [launcher] [app]\n", argv[0]);
exit(0);
}
/* check to see if we are using an intermediate launcher - we only
* support those we recognize */
found = false;
requested_launcher = basename(argv[1]);
for (n = 0; NULL != launchers[n]; n++) {
if (0 == strcmp(requested_launcher, launchers[n])) {
found = true;
}
}
if (!found) {
char *tmp = PMIX_ARGV_JOIN_COMPAT(launchers, ',');
fprintf(stderr, "Wrong test, dude - unknown launcher\n");
fprintf(stderr, "Known launchers: %s\n", tmp);
free(tmp);
exit(1);
}
pid = getpid();
info = NULL;
ninfo = 0;
/* do not connect to anyone */
PMIX_INFO_LIST_START(dirs);
PMIX_INFO_LIST_ADD(rc, dirs, PMIX_TOOL_DO_NOT_CONNECT, NULL, PMIX_BOOL);
PMIX_INFO_LIST_ADD(rc, dirs, PMIX_LAUNCHER, NULL, PMIX_BOOL);
PMIX_INFO_LIST_ADD(rc, dirs, PMIX_IOF_LOCAL_OUTPUT, NULL, PMIX_BOOL);
PMIX_INFO_LIST_CONVERT(rc, dirs, &darray);
PMIX_INFO_LIST_RELEASE(dirs);
info = darray.array;
ninfo = darray.size;
/* init as a tool */
if (PMIX_SUCCESS != (rc = PMIx_tool_init(&myproc, info, ninfo))) {
fprintf(stderr, "PMIx_tool_init failed: %s(%d)\n", PMIx_Error_string(rc), rc);
exit(rc);
}
PMIX_DATA_ARRAY_DESTRUCT(&darray);
printf("Debugger ns %s rank %d pid %lu: Running\n", myproc.nspace, myproc.rank,
(unsigned long) pid);
/* get our URI as we will need it later */
#ifdef PMIX_MYSERVER_URI
rc = PMIx_Get(&myproc, PMIX_MYSERVER_URI, NULL, 0, &val);
#else
rc = PMIx_Get(&myproc, PMIX_SERVER_URI, NULL, 0, &val);
#endif
if (PMIX_SUCCESS != rc) {
fprintf(stderr, "Failed to retrieve our URI: %s\n", PMIx_Error_string(rc));
PMIx_tool_finalize();
exit(rc);
}
myuri = strdup(val->data.string);
PMIX_VALUE_RELEASE(val);
printf("DEBUGGER URI: %s\n", myuri);
/* register an event handler to pickup when the IL
* we spawned dies */
DEBUG_CONSTRUCT_LOCK(&mylock);
code = PMIX_ERR_LOST_CONNECTION;
PMIX_INFO_CREATE(info, 1);
PMIX_INFO_LOAD(&info[0], PMIX_EVENT_HDLR_NAME, "LOST-CONNECTION", PMIX_STRING);
PMIx_Register_event_handler(&code, 1, info, 1, terminate_fn, evhandler_reg_callbk,
(void *) &mylock);
DEBUG_WAIT_THREAD(&mylock);
DEBUG_DESTRUCT_LOCK(&mylock);
PMIX_INFO_FREE(info, 1);
/* register a default event handler */
DEBUG_CONSTRUCT_LOCK(&mylock);
PMIX_INFO_CREATE(info, 1);
PMIX_INFO_LOAD(&info[0], PMIX_EVENT_HDLR_NAME, "DEFAULT", PMIX_STRING);
PMIx_Register_event_handler(NULL, 0, info, 1, notification_fn, evhandler_reg_callbk,
(void *) &mylock);
DEBUG_WAIT_THREAD(&mylock);
DEBUG_DESTRUCT_LOCK(&mylock);
PMIX_INFO_FREE(info, 1);
/* we are using an intermediate launcher - we will either use the
* reference server to start it or will fork/exec it ourselves,
* but either way tell it to wait after launch for directives */
napps = 1;
PMIX_APP_CREATE(app, napps);
/* setup the executable */
app[0].cmd = strdup(argv[1]);
PMIX_ARGV_APPEND(rc, app[0].argv, argv[1]);
/* pass it the rest of the cmd line as we don't know
* how to parse it */
for (n = 2; n < argc; n++) {
PMIX_ARGV_APPEND(rc, app[0].argv, argv[n]);
}
if (NULL == getcwd(cwd, 1024)) { // point us to our current directory
exit(1);
}
app[0].cwd = strdup(cwd);
app[0].maxprocs = 1; // only start one instance of the IL
/* tell the IL how to connect back to us */
PMIX_SETENV(rc, PMIX_LAUNCHER_RNDZ_URI, myuri, &app[0].env);
if (PMIX_SUCCESS != rc) {
fprintf(stderr, "Failed to set URI in app environment: %s\n", PMIx_Error_string(rc));
PMIx_tool_finalize();
exit(rc);
}
/* provide job-level directives so the launcher does what we want
* when it spawns the actual job - note that requesting the stdout
* and stderr of the launcher will automatically get us the output
* from the application as the launcher will have had it forwarded
* to itself */
PMIX_INFO_LIST_START(jinfo);
/* create the launch directives to tell the launcher what
* to do with the app it is going to spawn for us */
PMIX_INFO_LIST_START(linfo);
rank = PMIX_RANK_WILDCARD;
if (NULL != strstr(argv[1], "mpi")) {
PMIX_INFO_LIST_ADD(rc, linfo, PMIX_DEBUG_STOP_IN_APP, NULL, PMIX_BOOL); // stop all procs in MPI_Init
} else {
PMIX_INFO_LIST_ADD(rc, linfo, PMIX_DEBUG_STOP_IN_INIT, NULL, PMIX_BOOL); // stop all procs in PMIx_Init
}
PMIX_INFO_LIST_ADD(rc, linfo, PMIX_NOTIFY_JOB_EVENTS, NULL, PMIX_BOOL);
PMIX_INFO_LIST_ADD(rc, linfo, PMIX_FWD_STDOUT, NULL, PMIX_BOOL); // forward stdout to me
PMIX_INFO_LIST_ADD(rc, linfo, PMIX_FWD_STDERR, NULL, PMIX_BOOL); // forward stderr to me
PMIX_INFO_LIST_CONVERT(rc, linfo, &darray2);
PMIX_INFO_LIST_ADD(rc, jinfo, PMIX_LAUNCH_DIRECTIVES, &darray2, PMIX_DATA_ARRAY);
PMIX_INFO_LIST_RELEASE(linfo);
/* convert job info to array */
PMIX_INFO_LIST_CONVERT(rc, jinfo, &darray);
PMIX_INFO_LIST_RELEASE(jinfo);
info = (pmix_info_t *) darray.array;
ninfo = darray.size;
/* spawn the launcher - the function will return when the launcher
* has been started. */
printf("SPAWNING LAUNCHER\n");
rc = PMIx_Spawn(info, ninfo, app, napps, clientspace);
PMIX_DATA_ARRAY_DESTRUCT(&darray);
PMIX_DATA_ARRAY_DESTRUCT(&darray2);
PMIX_APP_FREE(app, napps);
if (PMIX_SUCCESS != rc) {
fprintf(stderr, "Launcher %s failed to start with error: %s(%d)\n", argv[1],
PMIx_Error_string(rc), rc);
goto done;
}
printf("RECONNECT TO IL AT %s\n", clientspace);
/* set the spawned launcher as our primary server - wait for
* it to connect to us but provide a timeout so we don't hang
* waiting forever. The launcher shall connect to us prior
* to spawning the job we provided it */
PMIX_LOAD_PROCID(&proc, clientspace, 0);
PMIX_INFO_LIST_START(dirs);
timeout = 2;
PMIX_INFO_LIST_ADD(rc, dirs, PMIX_WAIT_FOR_CONNECTION, NULL, PMIX_BOOL);
PMIX_INFO_LIST_ADD(rc, dirs, PMIX_TIMEOUT, &timeout, PMIX_INT);
PMIX_INFO_LIST_CONVERT(rc, dirs, &darray);
PMIX_INFO_LIST_RELEASE(dirs);
info = darray.array;
ninfo = darray.size;
rc = PMIx_tool_set_server(&proc, info, ninfo);
if (PMIX_SUCCESS != rc) {
/* connection failed */
fprintf(stderr, "Failed to set spawned launcher as primary server: %s\n",
PMIx_Error_string(rc));
goto done;
}
PMIX_DATA_ARRAY_DESTRUCT(&darray);
/* register to receive the ready-for-debug event alerting us that things are ready
* for us to spawn the debugger daemons - this will be registered
* with the IL we started */
printf("REGISTERING READY-FOR-DEBUG HANDLER\n");
DEBUG_CONSTRUCT_LOCK(&mylock);
code = PMIX_READY_FOR_DEBUG;
PMIX_INFO_LIST_START(dirs);
PMIX_INFO_LIST_ADD(rc, dirs, PMIX_EVENT_HDLR_NAME, "READY-FOR-DEBUG", PMIX_STRING);
PMIX_INFO_LIST_CONVERT(rc, dirs, &darray);
PMIX_INFO_LIST_RELEASE(dirs);
info = darray.array;
ninfo = darray.size;
PMIx_Register_event_handler(&code, 1, info, ninfo, spawn_cbfunc, evhandler_reg_callbk,
(void *) &mylock);
DEBUG_WAIT_THREAD(&mylock);
DEBUG_DESTRUCT_LOCK(&mylock);
PMIX_DATA_ARRAY_DESTRUCT(&darray);
if (!ilactive) {
fprintf(stderr, "Error: Launcher not active\n");
goto done;
}
printf("RELEASING %s [%s,%d]\n", argv[1], proc.nspace, proc.rank);
/* release the IL to spawn its job */
PMIX_INFO_LIST_START(dirs);
PMIX_INFO_LIST_ADD(rc, dirs, PMIX_EVENT_NON_DEFAULT, NULL, PMIX_BOOL);
/* target this notification solely to that one tool */
PMIX_INFO_LIST_ADD(rc, dirs, PMIX_EVENT_CUSTOM_RANGE, &proc, PMIX_PROC);
PMIX_INFO_LIST_CONVERT(rc, dirs, &darray);
PMIX_INFO_LIST_RELEASE(dirs);
info = darray.array;
ninfo = darray.size;
PMIx_Notify_event(PMIX_DEBUGGER_RELEASE, &myproc, PMIX_RANGE_CUSTOM, info, ninfo, NULL, NULL);
PMIX_DATA_ARRAY_DESTRUCT(&darray);
printf("WAITING FOR APPLICATION LAUNCH\n");
/* wait for the IL to have launched its application */
int icount = 0;
while (dbactive && ilactive) {
struct timespec tp = {0, 500000000};
nanosleep(&tp, NULL);
++icount;
if (icount > 20) {
fprintf(stderr, "Error: Failed to launch by the timeout\n");
goto done;
}
}
if (!ilactive) {
/* the launcher failed */
fprintf(stderr, "Error: Launcher failed\n");
goto done;
}
if (NULL == appnspace) {
fprintf(stderr, "Error: The application has failed to launch\n");
goto done;
}
printf("APPLICATION HAS LAUNCHED: %s\n", (char *) appnspace);
/* we want to forward our stdin to the launcher we
* started - it will know what to do with its stdin */
PMIX_LOAD_PROCID(&proc, (char*)clientspace, PMIX_RANK_WILDCARD);
DEBUG_CONSTRUCT_LOCK(&mylock);
PMIX_INFO_LOAD(&iofinfo, PMIX_IOF_PUSH_STDIN, NULL, PMIX_BOOL);
rc = PMIx_IOF_push(&proc, 1, NULL, &iofinfo, 1, opcbfunc, &mylock);
if (PMIX_SUCCESS != rc && PMIX_OPERATION_SUCCEEDED != rc) {
fprintf(stderr, "IOF push of stdin failed: %s\n", PMIx_Error_string(rc));
DEBUG_DESTRUCT_LOCK(&mylock);
goto done;
} else if (PMIX_SUCCESS == rc) {
DEBUG_WAIT_THREAD(&mylock);
if (PMIX_SUCCESS != mylock.status) {
fprintf(stderr, "IOF push of stdin failed: %s\n", PMIx_Error_string(rc));
DEBUG_DESTRUCT_LOCK(&mylock);
goto done;
}
}
DEBUG_DESTRUCT_LOCK(&mylock);
/* setup the debugger */
mydata = (myquery_data_t *) malloc(sizeof(myquery_data_t));
mydata->napps = 1;
PMIX_APP_CREATE(mydata->apps, mydata->napps);
mydata->apps[0].cmd = strdup("./daemon");
PMIX_ARGV_APPEND(rc, mydata->apps[0].argv, "./daemon");
if (NULL == getcwd(cwd, 1024)) { // point us to our current directory
exit(1);
}
mydata->apps[0].cwd = strdup(cwd);
mydata->apps[0].maxprocs = 1;
PMIX_LOAD_PROCID(&target_proc, (void *) appnspace, PMIX_RANK_WILDCARD);
/* provide directives so the daemons go where we want, and
* let the RM know these are debugger daemons */
PMIX_INFO_LIST_START(dirs);
PMIX_INFO_LIST_ADD(rc, dirs, PMIX_MAPBY, "ppr:1:node",
PMIX_STRING); // instruct the RM to launch one copy of the executable on each
// node
PMIX_INFO_LIST_ADD(rc, dirs, PMIX_DEBUGGER_DAEMONS, NULL,
PMIX_BOOL); // these are debugger daemons
PMIX_INFO_LIST_ADD(rc, dirs, PMIX_DEBUG_TARGET, &target_proc,
PMIX_PROC); // the nspace being debugged
PMIX_INFO_LIST_ADD(rc, dirs, PMIX_NOTIFY_COMPLETION, NULL,
PMIX_BOOL); // notify us when the debugger job completes
PMIX_INFO_LIST_ADD(rc, dirs, PMIX_FWD_STDOUT, NULL, PMIX_BOOL); // forward stdout to me
PMIX_INFO_LIST_ADD(rc, dirs, PMIX_FWD_STDERR, NULL, PMIX_BOOL); // forward stderr to me
PMIX_INFO_LIST_CONVERT(rc, dirs, &darray);
PMIX_INFO_LIST_RELEASE(dirs);
mydata->info = darray.array;
mydata->ninfo = darray.size;
darray.array = NULL;
darray.size = 0;
PMIX_DATA_ARRAY_DESTRUCT(&darray);
/* spawn the daemons */
printf("Debugger: spawning %s\n", mydata->apps[0].cmd);
rc = PMIx_Spawn(mydata->info, mydata->ninfo, mydata->apps, mydata->napps, dbnspace);
PMIX_INFO_FREE(mydata->info, mydata->ninfo);
PMIX_APP_FREE(mydata->apps, mydata->napps);
if (PMIX_SUCCESS != rc) {
fprintf(stderr, "Debugger daemons failed to launch with error: %s\n",
PMIx_Error_string(rc));
free(mydata);
goto done;
}
free(mydata);
/* wait for the IL to terminate */
printf("WAITING FOR IL TO TERMINATE\n");
while (ilactive) {
struct timespec tp = {0, 500000};
nanosleep(&tp, NULL);
}
done:
PMIx_tool_finalize();
if (NULL != myuri) {
free(myuri);
}
return (rc);
}
|