dacs_de_start

NAME

dacs_de_start - Start a process on a DE.

SYNOPSIS

DACS_ERR_T dacs_de_start ( de_id_t de, void *prog, char const **argv, char const **envv, DACS_PROC_CREATION_FLAG_T creation_flags, dacs_process_id_t *pid )

Call parameters  
de The target DE where the program will execute.
*prog A pointer to the program text to execute. What this points to is platform-dependent, and also dependent on the creation_flags parameter.
**argv A pointer to an array of pointers to argument strings (the argument list), terminated by a NULL pointer.
**envv A pointer to an array of pointers to environment variable strings (the environment list), terminated by a NULL pointer.
creation_flags An implementation-specific flag that specifies how the executable program is found. This can be any of:
  • DACS_PROC_LOCAL_FILE: a fully qualified pathname,
  • DACS_PROC_LOCAL_FILE_LIST: a list of fully qualified pathnames,
  • DACS_PROC_REMOTE_FILE: a fully qualified path on a remote system, or
  • DACS_PROC_EMBEDDED: the handle of an embedded executable image.
Return parameter  
*pid A pointer to a location where the process id is stored on successful return.

DESCRIPTION

The dacs_de_start service starts a process on the specified DE. The service can be called several times to start one or more processes on the same DE. The number of processes that can be started on a particular DE is platform and implementation dependent.

RETURN VALUE

The dacs_de_start service returns an error indicator defined as:
  • DACS_SUCCESS: normal return.
  • DACS_ERR_INVALID_ADDR: a pointer is invalid.
  • DACS_ERR_INVALID_ATTR: a flag or enumerated constant is invalid.
  • DACS_ERR_NO_RESOURCE: unable to allocate required resources.
  • DACS_ERR_PROHIBITED: the operation is prohibited by the implementation.
  • DACS_ERR_INVALID_DE: the specified DE is either invalid or not reserved.
  • DACS_ERR_INVALID_TARGET: the operation is not allowed for the target DE.
  • DACS_ERR_PROC_LIMIT: the maximum number of processes supported has been reached.
  • DACS_ERR_INVALID_PROG: the specified program could not be executed.
  • DACS_ERR_INVALID_ARGV: argv is too large or invalid.
  • DACS_ERR_INVALID_ENV: envv is too large or invalid.

SEE ALSO

dacs_num_processes_supported(3), dacs_num_processes_running(3), dacs_de_wait(3), dacs_de_test(3)