← Back to branch summary

~ubuntu-branches/debian/lenny/freetds/lenny

« back to all changes in this revision

Viewing changes to doc/doc/freetds-0.82/userguide/interfacespurpose.htm

  • Committer: Bazaar Package Importer
  • Author(s): Steve Langasek
  • Date: 2008-08-02 11:49:53 UTC
  • mfrom: (2.1.10 intrepid)
  • Revision ID: james.westby@ubuntu.com-20080802114953-0qdeowgl63k42n2c
Tags: 0.82-4
http://bugs.debian.org/493303
* Fix a typo in the freetds-common description, ugh
* Versioned replaces of libct4 by freetds-common, since the current one
  obviously doesn't have overlapping files.
* tdsodbc: check for /var/lib/odbc existence before removing it in the
  postinst, since there are cases where it won't exist on upgrade (i.e.,
  if the driver was never enabled in the first place).  Closes: #493303.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/doc/freetds-0.82/userguide/interfacespurpose.htm
 
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
 
2
<HTML
 
3
><HEAD
 
4
><TITLE
 
5
>What it does</TITLE
 
6
><META
 
7
NAME="GENERATOR"
 
8
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
 
9
REL="HOME"
 
10
TITLE="FreeTDS User Guide"
 
11
HREF="index.htm"><LINK
 
12
REL="UP"
 
13
TITLE="The interfaces File"
 
14
HREF="interfacesfile.htm"><LINK
 
15
REL="PREVIOUS"
 
16
TITLE="Where it goes"
 
17
HREF="interfaceslocation.htm"><LINK
 
18
REL="NEXT"
 
19
TITLE="What it looks like"
 
20
HREF="interfacesformat.htm"><LINK
 
21
REL="STYLESHEET"
 
22
TYPE="text/css"
 
23
HREF="userguide.css"></HEAD
 
24
><BODY
 
25
CLASS="SECT1"
 
26
BGCOLOR="#FFFFFF"
 
27
TEXT="#000000"
 
28
LINK="#0000FF"
 
29
VLINK="#840084"
 
30
ALINK="#0000FF"
 
31
><DIV
 
32
CLASS="NAVHEADER"
 
33
><TABLE
 
34
SUMMARY="Header navigation table"
 
35
WIDTH="100%"
 
36
BORDER="0"
 
37
CELLPADDING="0"
 
38
CELLSPACING="0"
 
39
><TR
 
40
><TH
 
41
COLSPAN="3"
 
42
ALIGN="center"
 
43
><SPAN
 
44
CLASS="PRODUCTNAME"
 
45
>FreeTDS</SPAN
 
46
> User Guide: A Guide to Installing, Configuring, and Running <SPAN
 
47
CLASS="PRODUCTNAME"
 
48
>FreeTDS</SPAN
 
49
></TH
 
50
></TR
 
51
><TR
 
52
><TD
 
53
WIDTH="10%"
 
54
ALIGN="left"
 
55
VALIGN="bottom"
 
56
><A
 
57
HREF="interfaceslocation.htm"
 
58
ACCESSKEY="P"
 
59
>Prev</A
 
60
></TD
 
61
><TD
 
62
WIDTH="80%"
 
63
ALIGN="center"
 
64
VALIGN="bottom"
 
65
>Appendix A. The <TT
 
66
CLASS="FILENAME"
 
67
>interfaces</TT
 
68
> File</TD
 
69
><TD
 
70
WIDTH="10%"
 
71
ALIGN="right"
 
72
VALIGN="bottom"
 
73
><A
 
74
HREF="interfacesformat.htm"
 
75
ACCESSKEY="N"
 
76
>Next</A
 
77
></TD
 
78
></TR
 
79
></TABLE
 
80
><HR
 
81
ALIGN="LEFT"
 
82
WIDTH="100%"></DIV
 
83
><DIV
 
84
CLASS="SECT1"
 
85
><H1
 
86
CLASS="SECT1"
 
87
><A
 
88
NAME="INTERFACESPURPOSE"
 
89
>What it does</A
 
90
></H1
 
91
><P
 
92
>The <TT
 
93
CLASS="FILENAME"
 
94
>interfaces</TT
 
95
> file aliases a dataserver name to the hostname and port number of the dataserver's machine.  When <SPAN
 
96
CLASS="PRODUCTNAME"
 
97
>FreeTDS</SPAN
 
98
> receives a request to connect to a database server, it looks up the dataserver name in <TT
 
99
CLASS="FILENAME"
 
100
>interfaces</TT
 
101
>.  There, it finds the machine name (or address) and port number to connect to, that is, the port where the database server is listening.  
 
102
                        </P
 
103
><DIV
 
104
CLASS="TIP"
 
105
><P
 
106
></P
 
107
><TABLE
 
108
CLASS="TIP"
 
109
WIDTH="100%"
 
110
BORDER="0"
 
111
><TR
 
112
><TD
 
113
WIDTH="25"
 
114
ALIGN="CENTER"
 
115
VALIGN="TOP"
 
116
><IMG
 
117
SRC="../images/tip.gif"
 
118
HSPACE="5"
 
119
ALT="Tip"></TD
 
120
><TD
 
121
ALIGN="LEFT"
 
122
VALIGN="TOP"
 
123
><TABLE
 
124
CLASS="SIDEBAR"
 
125
BORDER="1"
 
126
CELLPADDING="5"
 
127
><TR
 
128
><TD
 
129
><DIV
 
130
CLASS="SIDEBAR"
 
131
><A
 
132
NAME="AEN5974"
 
133
></A
 
134
><P
 
135
><B
 
136
>How's that again?</B
 
137
></P
 
138
><P
 
139
>The <TT
 
140
CLASS="FILENAME"
 
141
>interfaces</TT
 
142
> file sometimes trips people up.  It seems innocuous enough, but it's also a pretty good example of <SPAN
 
143
CLASS="QUOTE"
 
144
>"it's easy if you know how"</SPAN
 
145
>.  Keep in mind:
 
146
                        </P
 
147
><P
 
148
></P
 
149
><UL
 
150
><LI
 
151
STYLE="list-style-type: disc"
 
152
><P
 
153
>The <SPAN
 
154
CLASS="emphasis"
 
155
><I
 
156
CLASS="EMPHASIS"
 
157
>dataserver name</I
 
158
></SPAN
 
159
> is the name of the database server.  When a database client specifies the <SPAN
 
160
CLASS="QUOTE"
 
161
>"name of the server"</SPAN
 
162
> to connect to, it's the <SPAN
 
163
CLASS="emphasis"
 
164
><I
 
165
CLASS="EMPHASIS"
 
166
>dataserver name</I
 
167
></SPAN
 
168
> that is used.  
 
169
                                        </P
 
170
></LI
 
171
><LI
 
172
STYLE="list-style-type: disc"
 
173
><P
 
174
>The <SPAN
 
175
CLASS="emphasis"
 
176
><I
 
177
CLASS="EMPHASIS"
 
178
>host name</I
 
179
></SPAN
 
180
> is the name of the host (machine) where the database server is running.  It has an IP address, and in almost any environment, you can <B
 
181
CLASS="COMMAND"
 
182
>ping</B
 
183
> the machine name to see if you've got it right.  After it uses the <SPAN
 
184
CLASS="emphasis"
 
185
><I
 
186
CLASS="EMPHASIS"
 
187
>dataserver name</I
 
188
></SPAN
 
189
>  to look up the <SPAN
 
190
CLASS="emphasis"
 
191
><I
 
192
CLASS="EMPHASIS"
 
193
>host name</I
 
194
></SPAN
 
195
>, <SPAN
 
196
CLASS="PRODUCTNAME"
 
197
>FreeTDS</SPAN
 
198
> will do the same thing <B
 
199
CLASS="COMMAND"
 
200
>ping</B
 
201
> does to get the IP address of the machine to connect to. 
 
202
                                        </P
 
203
></LI
 
204
><LI
 
205
STYLE="list-style-type: disc"
 
206
><P
 
207
>Finally, the <SPAN
 
208
CLASS="emphasis"
 
209
><I
 
210
CLASS="EMPHASIS"
 
211
>port number</I
 
212
></SPAN
 
213
> is frequently overlooked.  From the network's point of view, knowing the IP address without the port number is a little like knowing the address of an apartment building without knowing the apartment number.  In both cases, it will be hard to find what you came for.  Make sure you <SPAN
 
214
CLASS="emphasis"
 
215
><I
 
216
CLASS="EMPHASIS"
 
217
>know</I
 
218
></SPAN
 
219
> the port number, and that it's correctly entered in the <TT
 
220
CLASS="FILENAME"
 
221
>interfaces</TT
 
222
> file.  
 
223
                                        </P
 
224
></LI
 
225
></UL
 
226
></DIV
 
227
></TD
 
228
></TR
 
229
></TABLE
 
230
></TD
 
231
></TR
 
232
></TABLE
 
233
></DIV
 
234
></DIV
 
235
><DIV
 
236
CLASS="NAVFOOTER"
 
237
><HR
 
238
ALIGN="LEFT"
 
239
WIDTH="100%"><TABLE
 
240
SUMMARY="Footer navigation table"
 
241
WIDTH="100%"
 
242
BORDER="0"
 
243
CELLPADDING="0"
 
244
CELLSPACING="0"
 
245
><TR
 
246
><TD
 
247
WIDTH="33%"
 
248
ALIGN="left"
 
249
VALIGN="top"
 
250
><A
 
251
HREF="interfaceslocation.htm"
 
252
ACCESSKEY="P"
 
253
>Prev</A
 
254
></TD
 
255
><TD
 
256
WIDTH="34%"
 
257
ALIGN="center"
 
258
VALIGN="top"
 
259
><A
 
260
HREF="index.htm"
 
261
ACCESSKEY="H"
 
262
>Home</A
 
263
></TD
 
264
><TD
 
265
WIDTH="33%"
 
266
ALIGN="right"
 
267
VALIGN="top"
 
268
><A
 
269
HREF="interfacesformat.htm"
 
270
ACCESSKEY="N"
 
271
>Next</A
 
272
></TD
 
273
></TR
 
274
><TR
 
275
><TD
 
276
WIDTH="33%"
 
277
ALIGN="left"
 
278
VALIGN="top"
 
279
>Where it goes</TD
 
280
><TD
 
281
WIDTH="34%"
 
282
ALIGN="center"
 
283
VALIGN="top"
 
284
><A
 
285
HREF="interfacesfile.htm"
 
286
ACCESSKEY="U"
 
287
>Up</A
 
288
></TD
 
289
><TD
 
290
WIDTH="33%"
 
291
ALIGN="right"
 
292
VALIGN="top"
 
293
>What it looks like</TD
 
294
></TR
 
295
></TABLE
 
296
></DIV
 
297
></BODY
 
298
></HTML
 
299
>
 
 
b'\\ No newline at end of file'