gbatch_cidel - delete a command interpreter
int gbatch_cidel(const int fd, const unsigned flags, const unsigned indx)
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.
The function returns 0 if successful otherwise one of the error codes listed in the start of this chapter.
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.
gbatch_ciadd(3)
,
gbatch_ciread(3)
,
gbatch_ciupd(3)
.
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.
John M Collins, Xi Software Ltd.