File: gnatcoll-remote-db.ads

package info (click to toggle)
libgnatcoll 18-4
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, buster, sid
  • size: 5,068 kB
  • sloc: ada: 40,393; python: 354; ansic: 310; makefile: 245; sh: 31
file content (105 lines) | stat: -rw-r--r-- 4,915 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
------------------------------------------------------------------------------
--                             G N A T C O L L                              --
--                                                                          --
--                     Copyright (C) 2008-2017, AdaCore                     --
--                                                                          --
-- This library is free software;  you can redistribute it and/or modify it --
-- under terms of the  GNU General Public License  as published by the Free --
-- Software  Foundation;  either version 3,  or (at your  option) any later --
-- version. This library is distributed in the hope that it will be useful, --
-- but WITHOUT ANY WARRANTY;  without even the implied warranty of MERCHAN- --
-- TABILITY or FITNESS FOR A PARTICULAR PURPOSE.                            --
--                                                                          --
--                                                                          --
--                                                                          --
--                                                                          --
--                                                                          --
-- 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/>.                                          --
--                                                                          --
------------------------------------------------------------------------------

--  This package is used to keep a global configuration of servers.
--  There are two almost identical parts: one defining static methods that
--  can be used by other GNATCOLL packages (such as GNATCOLL.IO.Remote),
--  and the second part that defines the actual configuration class, that
--  needs to be implemented and registered by the user code.

package GNATCOLL.Remote.Db is

   Invalid_Remote_Configuration : exception;

   ---------------------------------------------------
   -- The remote configuration interface definition --
   ---------------------------------------------------

   type Remote_Db_Interface is interface;

   function Is_Configured
     (Config   : Remote_Db_Interface;
      Nickname : String) return Boolean is abstract;
   --  Tell if a server with this name exists in the global configuration

   function Get_Server
     (Config   : Remote_Db_Interface;
      Nickname : String) return Server_Access is abstract;
   --  Get the server from its nickname.

   function Nb_Mount_Points
     (Config   : Remote_Db_Interface;
      Nickname : String) return Natural is abstract;
   --  Get the number of mount points defined for the server

   function Get_Mount_Point_Local_Root
     (Config   : Remote_Db_Interface;
      Nickname : String;
      Index    : Natural) return FS_String is abstract;
   --  Get the local mount point

   function Get_Mount_Point_Host_Root
     (Config   : Remote_Db_Interface;
      Nickname : String;
      Index    : Natural) return FS_String is abstract;
   --  Get the remote point.

   ---------------------------------------------------------
   -- Needs to be called before any of the static methods --
   ---------------------------------------------------------

   procedure Define_Remote_Configuration
     (Config : access Remote_Db_Interface'Class);
   --  Defines the remote configuration that will be used for all remote access
   --  performed by GNATCOLL.

   -------------------------------------------------
   --  Static methods used by GNATCOLL internally --
   -------------------------------------------------

   function Is_Configured (Nickname : String) return Boolean;
   --  Tell if a server with this name exists in the global configuration
   --  Raise Invalid_Remote_Config if no global configuration has been defined.

   function Get_Server (Nickname : String) return Server_Access;
   --  Get the server from its nickname.
   --  Raise Invalid_Remote_Config if no global configuration has been defined.

   function Nb_Mount_Points
     (Nickname : String) return Natural;
   --  Get the number of mount points defined for the server
   --  Raise Invalid_Remote_Config if no global configuration has been defined.

   function Get_Mount_Point_Local_Root
     (Nickname : String;
      Index    : Natural) return FS_String;
   --  Get the local mount point
   --  Raise Invalid_Remote_Config if no global configuration has been defined.

   function Get_Mount_Point_Host_Root
     (Nickname : String;
      Index    : Natural) return FS_String;
   --  Get the remote point.
   --  Raise Invalid_Remote_Config if no global configuration has been defined.

end GNATCOLL.Remote.Db;