NAME

gbatch_cidel - delete a command interpreter


SYNOPSIS

#include <gbatch.h>

int gbatch_cidel(const int fd, const unsigned flags, const unsigned indx)


DESCRIPTION

The function gbatch_cidel is used to delete a command interpreter from a GNUbatch server. The invoking user must have special create permission or the call will be rejected.

fd is a file descriptor which was previously returned by a successful call to gbatch_open(3).

flags is currently unused, but is reserved for future extensions.

indx is the number of the command interpreter to be deleted.


RETURN VALUES

The function returns 0 if successful otherwise one of the error codes listed in the start of this chapter.


NOTES

The standard shell entry, entry zero, cannot be deleted and attempts to do so will always return an error code (XBAPI_BAD_CI).

There are few checks and interlocks on command interpreter lists, which are assumed to be likely to be changed sparingly. The user should satisfy him or herself that there are no jobs likely to use the command interpreter about to be deleted before invoking this operation.


SEE ALSO

gbatch_ciadd(3), gbatch_ciread(3), gbatch_ciupd(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.