ios_delete() — Apollo

IOS_$DELETE                       Domain/OS                        IOS_$DELETE


NAME
     ios_$delete - delete an object

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/ios.h>

     void ios_$delete(
          ios_$id_t &stream_id,
          status_$t *status)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/ios.ins.pas';

     procedure ios_$delete(
          in stream_id: ios_$id_t;
          out status: status_$t);

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/ios.ins.ftn'

           integer*2 stream_id
           integer*4 status

           call ios_$delete(stream_id, status)

DESCRIPTION
     Ios_$delete sets the object attribute ios_$of_delete_on_close for the
     object open on stream_id, then closes the stream.  So, if the type
     manager does not support the delete-on-close attribute, the ios_$delete
     call will fail; that is, the call closes the stream but does not delete
     the object.

     If the object is open on more than one stream, ios_$delete marks the
     object for deletion, but the object is not actually deleted until all
     streams to the object are closed.

     stream_id
          The ID of a stream on which the object is open.

     status
          The completion status.
Museum
