gbatch_getenvlist(3)

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.