Short:        Shell access to 'nonvolatile.library'
Author:       Stefan Le Breton (slbrbbbh@sp.zrz.TU-Berlin.de)
Uploader:     Stefan Le Breton (slbrbbbh sp zrz TU-Berlin de)
Type:         util/cli
Version:      1.0
Requires:     OS 2.0+ nonvolatile.library (OS 3.1)
Architecture: m68k-amigaos
Distribution: free
Copyright:    ©1995 Stefan Le Breton
Restrictions: no military or life critical use, complete archive
Archive:      NVUtils.lha
Date:         30.09.95
Downloader:   probably YOU :)

--8<--

    NVUtils
    ¯¯¯¯¯¯¯
    nonvolatile.library is not limited to installed NVRAM as most people might think.
    It searches a file prefs/env-archive/sys/nv_location on every disk, if found
    the contents is interpreted as a path to a directory, where the nonvolatile
    data is saved.

    All data that is stored with application and an individual name for it.
    Names are limited to legal filenames.
    E.g. your application is 'MegaBonzo' and you store an item with the name 'cancel'
    the actual data is 'true'. The library is not limited to ascii data, but
    binary is not possible with shell access.
    As there is the possibility that read/write errors occures, requesters might
    pop up, this can be disabled with the KILLREQUESTER option.

    NVUtils provides access to every function of the library.
______________________________________________________________________________
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    SetNV <appname> <itemname> [KILLREQUESTER] <data>
      Saves data.

    GetNV <appname> <itemname> [KILLREQUESTER]
      Prints associated data.

    UnsetNV <appname> <itemname> [KILLREQUESTER]
      Removes data.
      If there was no such data, the returncode is set to 5 (WARN).

    ListNV <appname> [KILLREQUESTER]
      Lists stored items for <appname>.
      Delete protected items are marked with '*'.

    ProtectNV <appname> <itemname> [KILLREQUESTER] <prot>
      (Un)Protects data from deletion.
      <prot> is +d for protection, -d for no protection.
______________________________________________________________________________
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
The programs need V37 (2.0).
I don't know if the library requires V40 (OS 3.1), but if the library works
with OS 2.0 #?NV will too.

Oberonsource is provided.

Yes, I know the binaries are quite large, but I just wanted to show what's possible...

-->8--