This file is indexed.

/usr/share/doc/gnat-gps/html/Connection-settings.html is in gnat-gps-doc 5.0-6.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  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
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
<html lang="en">
<head>
<title>Connection settings - Using the GNAT Programming Studio</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Using the GNAT Programming Studio">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Setup-the-remote-servers.html#Setup-the-remote-servers" title="Setup the remote servers">
<link rel="prev" href="The-remote-configuration-dialog.html#The-remote-configuration-dialog" title="The remote configuration dialog">
<link rel="next" href="Paths-settings.html#Paths-settings" title="Paths settings">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
Copyright (C) 2002-2010 AdaCore.

This document is free; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.

This document is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, see `http://www.gnu.org/licenses/'.-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
  pre.display { font-family:inherit }
  pre.format  { font-family:inherit }
  pre.smalldisplay { font-family:inherit; font-size:smaller }
  pre.smallformat  { font-family:inherit; font-size:smaller }
  pre.smallexample { font-size:smaller }
  pre.smalllisp    { font-size:smaller }
  span.sc    { font-variant:small-caps }
  span.roman { font-family:serif; font-weight:normal; } 
  span.sansserif { font-family:sans-serif; font-weight:normal; } 
pre.smallexample {background-color:rgb(240,240,240);
                     font-family: courier new,courier,fixed;
                     font-size: 14px;
                     margin: 0px 40px 0px 40px;
                     border-width: 1px 2px 2px 1px;
                     border-top-style: dotted;
                     border-left-style: dotted;
                     border-right-style: solid;
                     border-bottom-style: solid;
                     border-color: black;}
   code             {color:black;
                     font-family: courier new,courier,fixed;
                     font-size: 14px;}
   body             {font-family: arial,helvetica,sans-serif;
                     font-size: 16px;
                     max-width: 800px;
                     text-align: justify}
   samp             {font-family: courier new,courier,fixed;
                     font-size: 14px}
                    
--></style>
</head>
<body>
<div class="node">
<a name="Connection-settings"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="Paths-settings.html#Paths-settings">Paths settings</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="The-remote-configuration-dialog.html#The-remote-configuration-dialog">The remote configuration dialog</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="Setup-the-remote-servers.html#Setup-the-remote-servers">Setup the remote servers</a>
<hr>
</div>

<h4 class="subsection">15.2.2 Connection settings</h4>

<!--  -->
<p>The first configuration part that needs to be filled concerns the way
we will connect to this server:

   <p>You have to enter first all mandatory fields, identified by an asterisk:
     <ul>
<li>The network name is the name used to connect to this server via your network. 
It can be either an IP address, a host name of your local network, or a fully
qualified network name. 
<li>The remote access tool is the tool used to connect to this server. You select
it using the drop down list. The following tools are supported natively by
GPS: ssh, rsh, telnet and plink (Windows tool) in ssh, rsh or telnet mode. 
See <a href="Defining-a-remote-connection-tool.html#Defining-a-remote-connection-tool">Defining a remote connection tool</a>, if you need to add a
specific tool. 
Note also that if one of those tools is not installed (e.g. is not in
your path), then it won't appear in the tools list. Some tools incompatible
with GPS will not be displayed either, such as the Microsoft telnet client. 
<li>The shell tells GPS what shell runs on the remote server. The following unix
shells are supported by GPS: sh, bash, csh and tcsh. Windows' shell is also
supported (cmd.exe). See <a href="Limitations.html#Limitations">Limitations</a>, for cygwin's shell usage on
windows: it is preferable to use cmd.exe as a remote shell on Windows servers. 
</ul>

<p class="noindent">Other fields might need to be taken into consideration, but they are not
mandatory. They are, for the most part, accessible through the advanced
configuration pane.

     <ul>
<li>The remote sync tool is used to synchronize remote and local filesystems, if
these are not shared filesystems. For now, only rsync is supported. 
<li>The Extra Init Commands field represents initialization commands sent to the
server upon connection: when GPS connects to your remote machine, the chosen
shell is launched, and your default initialization files are read (i.e. .bashrc
file for the bash shell). Then GPS sends these extra init commands, allowing
you for example to specify a compilation toolchain. 
<li>(In Advanced configuration pane) The user name specifies the name used to
connect to the server. If unspecified, the remote access tool will typically
use your current login name. If not, and a user name is requested, GPS will
prompt you for a user name. 
<li>(In Advanced configuration pane) The timeout value is used to determine if a connection to a remote host is
dead. All elementary operations performed on the remote host (i.e., operations
that normally complete almost immediately) will use this timeout value. By
default, this value is set to 10s. If you have a very slow network connection
or a very overloaded server, set this timeout to a higher value. 
<li>(In Advanced configuration pane) The maximum number of connections determines the maximum number of simultaneous
connections GPS is allowed to have to this server. In fact, if you want to
compile, debug and execute at the same time on the machine, GPS will need
more that one connection to do this. The default value is 3. 
<li>(In Advanced configuration pane) Depending on the kind of server and the remote
access tool used, commands sent to the server may require a specific line terminator,
i.e., either the LF character or CR/LF characters. Usually GPS can automatically detect what is needed
(the 'auto' mode), but the choice can be forced to CR/LF (cr/lf handling
set to 'on') or LF (cr/lf handling set to 'off'). 
<li>(In Advanced configuration pane) The Debug console allows you to easily
debug a remote connection. If checked, it will open a console
reporting all exchanges between GPS and the selected server. 
</ul>

<!--  -->
   </body></html>