From mboxrd@z Thu Jan  1 00:00:00 1970
X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me
X-Spam-Level: 
X-Spam-Status: No, score=-0.3 required=5.0 tests=BAYES_00,
	REPLYTO_WITHOUT_TO_CC autolearn=no autolearn_force=no version=3.4.4
Path: 
 border1.nntp.dca3.giganews.com!backlog3.nntp.dca3.giganews.com!border2.nntp.dca.giganews.com!nntp.giganews.com!newspeer1.nac.net!feeder.erje.net!eu.feeder.erje.net!newsfeed.datemas.de!rt.uk.eu.org!aioe.org!.POSTED!not-for-mail
From: "Dmitry A. Kazakov" <mailbox@dmitry-kazakov.de>
Newsgroups: comp.lang.ada
Subject: Re: Library cleanup
Date: Tue, 20 May 2014 18:20:08 +0200
Organization: cbb software GmbH
Message-ID: <1vqik1odcvjrw$.tsdp6cr7bp5y.dlg@40tude.net>
References: <llfjea$ov5$1@speranza.aioe.org>
Reply-To: mailbox@dmitry-kazakov.de
NNTP-Posting-Host: AuYlnUSfTZrfhAkRjyySpQ.user.speranza.aioe.org
Mime-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
X-Complaints-To: abuse@aioe.org
User-Agent: 40tude_Dialog/2.0.15.1
X-Notice: Filtered by postfilter v. 0.8.2
X-Original-Bytes: 2074
Xref: number.nntp.dca.giganews.com comp.lang.ada:186513
Date: 2014-05-20T18:20:08+02:00
List-Id: <comp.lang.ada>

On Tue, 20 May 2014 15:56:40 +0300, Victor Porton wrote:

> I am writing bindings for a C library which requires both initialization and 
> cleanup:
> 
> [[[
> raptor_init()
> raptor_finish()
> 
> Initialise and cleanup the library. These must be called before any raptor 
> class such as raptor_parser, raptor_uri is created or used. Note: as of 
> 1.4.19 these are wrappers around a static instance of the new raptor_world 
> class. In Raptor 2.0 this initialisation and cleanup method will be removed.
> ]]]
> 
> Initialization is clear: I just put it into the handled sequence of 
> statements of the package (should I also add Elaborate and/or Elaborate_Body 
> pragma?)
> 
> But how to do cleanup? That is, where to call raptor_finish()?
> 
> One way is to create a Limited_Controlled object in the package. Is there a 
> simpler way?

It is simple enough.

But much simpler is not to call raptor_finish() at all.

If the library is not OS-conformant, to clean up its internal persistent
state (does it have any?) upon unloading its instance, for example, when
the client application unexpectedly crashes, such a library must be removed
from the computer ASAP and never installed again.

-- 
Regards,
Dmitry A. Kazakov
http://www.dmitry-kazakov.de