gbatch_cidel(3)

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 an error code as defined in the include file gbatch.h.

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.