aboutsummaryrefslogtreecommitdiffstats
path: root/gcc-4.8/gcc/ada/g-regist.ads
diff options
context:
space:
mode:
Diffstat (limited to 'gcc-4.8/gcc/ada/g-regist.ads')
-rw-r--r--gcc-4.8/gcc/ada/g-regist.ads157
1 files changed, 0 insertions, 157 deletions
diff --git a/gcc-4.8/gcc/ada/g-regist.ads b/gcc-4.8/gcc/ada/g-regist.ads
deleted file mode 100644
index c7ad4dcfe..000000000
--- a/gcc-4.8/gcc/ada/g-regist.ads
+++ /dev/null
@@ -1,157 +0,0 @@
-------------------------------------------------------------------------------
--- --
--- GNAT COMPILER COMPONENTS --
--- --
--- G N A T . R E G I S T R Y --
--- --
--- S p e c --
--- --
--- Copyright (C) 2001-2011, Free Software Foundation, Inc. --
--- --
--- GNAT is free software; you can redistribute it and/or modify it under --
--- terms of the GNU General Public License as published by the Free Soft- --
--- ware Foundation; either version 3, or (at your option) any later ver- --
--- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
--- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
--- or FITNESS FOR A PARTICULAR PURPOSE. --
--- --
--- As a special exception under Section 7 of GPL version 3, you are granted --
--- additional permissions described in the GCC Runtime Library Exception, --
--- version 3.1, as published by the Free Software Foundation. --
--- --
--- You should have received a copy of the GNU General Public License and --
--- a copy of the GCC Runtime Library Exception along with this program; --
--- see the files COPYING3 and COPYING.RUNTIME respectively. If not, see --
--- <http://www.gnu.org/licenses/>. --
--- --
--- Extensive contributions were provided by Ada Core Technologies Inc. --
--- --
-------------------------------------------------------------------------------
-
--- The registry is a Windows database to store key/value pair. It is used
--- to keep Windows operation system and applications configuration options.
--- The database is a hierarchal set of key and for each key a value can
--- be associated. This package provides high level routines to deal with
--- the Windows registry. For full registry API, but at a lower level of
--- abstraction, refer to the Win32.Winreg package provided with the
--- Win32Ada binding. For example this binding handle only key values of
--- type Standard.String.
-
--- This package is specific to the NT version of GNAT, and is not available
--- on any other platforms.
-
-package GNAT.Registry is
-
- type HKEY is private;
- -- HKEY is a handle to a registry key, including standard registry keys:
- -- HKEY_CLASSES_ROOT, HKEY_CURRENT_CONFIG, HKEY_CURRENT_USER,
- -- HKEY_LOCAL_MACHINE, HKEY_USERS, HKEY_PERFORMANCE_DATA.
-
- HKEY_CLASSES_ROOT : constant HKEY;
- HKEY_CURRENT_USER : constant HKEY;
- HKEY_CURRENT_CONFIG : constant HKEY;
- HKEY_LOCAL_MACHINE : constant HKEY;
- HKEY_USERS : constant HKEY;
- HKEY_PERFORMANCE_DATA : constant HKEY;
-
- type Key_Mode is (Read_Only, Read_Write);
- -- Access mode for the registry key
-
- Registry_Error : exception;
- -- Registry_Error is raises by all routines below if a problem occurs
- -- (key cannot be opened, key cannot be found etc).
-
- function Create_Key
- (From_Key : HKEY;
- Sub_Key : String;
- Mode : Key_Mode := Read_Write) return HKEY;
- -- Open or create a key (named Sub_Key) in the Windows registry database.
- -- The key will be created under key From_Key. It returns the key handle.
- -- From_Key must be a valid handle to an already opened key or one of
- -- the standard keys identified by HKEY declarations above.
-
- function Open_Key
- (From_Key : HKEY;
- Sub_Key : String;
- Mode : Key_Mode := Read_Only) return HKEY;
- -- Return a registry key handle for key named Sub_Key opened under key
- -- From_Key. It is possible to open a key at any level in the registry
- -- tree in a single call to Open_Key.
-
- procedure Close_Key (Key : HKEY);
- -- Close registry key handle. All resources used by Key are released
-
- function Key_Exists (From_Key : HKEY; Sub_Key : String) return Boolean;
- -- Returns True if Sub_Key is defined under From_Key in the registry
-
- function Query_Value
- (From_Key : HKEY;
- Sub_Key : String;
- Expand : Boolean := False) return String;
- -- Returns the registry key's value associated with Sub_Key in From_Key
- -- registry key. If Expand is set to True and the Sub_Key is a
- -- REG_EXPAND_SZ the returned value will have the %name% variables
- -- replaced by the corresponding environment variable value.
-
- procedure Set_Value
- (From_Key : HKEY;
- Sub_Key : String;
- Value : String;
- Expand : Boolean := False);
- -- Add the pair (Sub_Key, Value) into From_Key registry key.
- -- By default the value created is of type REG_SZ, unless
- -- Expand is True in which case it is of type REG_EXPAND_SZ
-
- procedure Delete_Key (From_Key : HKEY; Sub_Key : String);
- -- Remove Sub_Key from the registry key From_Key
-
- procedure Delete_Value (From_Key : HKEY; Sub_Key : String);
- -- Remove the named value Sub_Key from the registry key From_Key
-
- generic
- with procedure Action
- (Index : Positive;
- Key : HKEY;
- Key_Name : String;
- Quit : in out Boolean);
- procedure For_Every_Key (From_Key : HKEY; Recursive : Boolean := False);
- -- Iterates over all the keys registered under From_Key, recursively if
- -- Recursive is set to True. Index will be set to 1 for the first key and
- -- will be incremented by one in each iteration. The current key of an
- -- iteration is set in Key, and its name - in Key_Name. Quit can be set
- -- to True to stop iteration; its initial value is False.
-
- generic
- with procedure Action
- (Index : Positive;
- Sub_Key : String;
- Value : String;
- Quit : in out Boolean);
- procedure For_Every_Key_Value (From_Key : HKEY; Expand : Boolean := False);
- -- Iterates over all the pairs (Sub_Key, Value) registered under
- -- From_Key. Index will be set to 1 for the first key and will be
- -- incremented by one in each iteration. Quit can be set to True to
- -- stop iteration; its initial value is False.
- --
- -- Key value that are not of type string (i.e. not REG_SZ / REG_EXPAND_SZ)
- -- are skipped. In this case, the iterator behaves exactly as if the key
- -- were not present. Note that you must use the Win32.Winreg API to deal
- -- with this case. Furthermore, if Expand is set to True and the Sub_Key
- -- is a REG_EXPAND_SZ the returned value will have the %name% variables
- -- replaced by the corresponding environment variable value.
- --
- -- This iterator can be used in conjunction with For_Every_Key in
- -- order to analyze all subkeys and values of a given registry key.
-
-private
-
- type HKEY is mod 2 ** Standard'Address_Size;
-
- HKEY_CLASSES_ROOT : constant HKEY := 16#80000000#;
- HKEY_CURRENT_USER : constant HKEY := 16#80000001#;
- HKEY_LOCAL_MACHINE : constant HKEY := 16#80000002#;
- HKEY_USERS : constant HKEY := 16#80000003#;
- HKEY_PERFORMANCE_DATA : constant HKEY := 16#80000004#;
- HKEY_CURRENT_CONFIG : constant HKEY := 16#80000005#;
-
-end GNAT.Registry;