[#ASYNC_start_job]
= ASYNC_start_job
:mrdocs:

Start or resume an asynchronous job.

== Synopsis

Declared in `<openssl/async.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
ASYNC_start_job(
    xref:ASYNC_JOB.adoc[ASYNC_JOB]** job,
    xref:ASYNC_WAIT_CTX.adoc[ASYNC_WAIT_CTX]* ctx,
    int* ret,
    int(* func)(void*),
    void* args,
    size_t size);
----

== Return Value

ASYNC_ERR, ASYNC_NO_JOBS, ASYNC_PAUSE, or ASYNC_FINISH.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *job*
| Location of the job pointer; updated when the job pauses or finishes.
| *ctx*
| Wait context used while the job is running.
| *ret*
| Receives the job function's return value when the job finishes.
| *func*
| Function to run asynchronously; receives `args.`
| *args*
| Argument passed to `func.`
| *size*
| Size in bytes of the memory copied into the job for `args.`
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#