gbatch_getenvlist - get the environment variable list from a job structure

# NAME

gbatch_getenvlist - get the environment variable list from a job structure

# SYNOPSIS

#include <gbatch.h>

const char **gbatch_getenv(const apiBtjob *jobp), const char *name)

# DESCRIPTION

The function gbatch_getenvlist is used to extract the list of environment variables from a job string table.

jobp is a pointer to a structure containing the details of the job.

# RETURN VALUES

The result is a null-terminated vector of environment variables in the form `NAME=VALUE`, or `NULL` if memory could not be allocated for it.

The space is allocated within the API. The user should not attempt to free it after use. Also note that the space is re=used if gbatch_getenv is invoked on a different job, the result should be copied if needed.

# SEE ALSO

gbatch_delarg(3), gbatch_delenv(3), gbatch_delenv(3), gbatch_delredir(3), gbatch_getarg(3), gbatch_getdirect(3), gbatch_getenv(3), gbatch_getenv(3), gbatch_getenvlist(3), gbatch_gethenv(3), gbatch_getredir(3), gbatch_gettitle(3), gbatch_putarg(3), gbatch_putarglist(3), gbatch_putdirect(3), gbatch_putenv(3), gbatch_putenv(3), gbatch_putenvlist(3), gbatch_putenvlist(3), gbatch_putredir(3), gbatch_putredirlist(3), gbatch_puttitle(3), gbatch_setqueue(3).

# COPYRIGHT

Copyright (c) 2009 Free Software Foundation, Inc. This is free software. You may redistribute copies of it under the terms of the GNU General Public License <http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent permitted by law.

# AUTHOR

John M Collins, Xi Software Ltd.