1DPNS_PING(3)                     DPNS      Library      Functions
2DPNS_PING(3)
3
4
5
6[1mNAME[0m
7       dpns_ping ‐ check if name server is alive and  return  its
8version number
9
10[1mSYNOPSIS[0m
11       [1m#include <sys/types.h>[0m
12       [1m#include "dpns_api.h"[0m
13
14       [1mint   dpns_ping   (char   *[4m[22mserver[24m[1m,   char
15*[4m[22minfo[24m[1m)[0m
16
17[1mDESCRIPTION[0m
18       [1mdpns_ping  [22mchecks  if  the name server is alive and
19returns its version
20       number.
21
22[1mOPTIONS[0m
23       [4mserver[24m specifies the DPNS Name Server hostname.  If
24NULL, the DPNS_HOST
25              environment variable is used.
26
27       [4minfo[24m   points  at  a  buffer  to receive the infor‐
28mation (currently the
29              version  number).   The  buffer  must be  at  least
30256  characters
31              long.
32
33[1mRETURN VALUE[0m
34       This  routine  returns  0  if the operation was successful
35or ‐1 if the
36       operation failed. In the latter case, [1mserrno [22mis set
37appropriately.
38
39[1mERRORS[0m
40       [1mEFAULT       [4m[22minfo[24m is a NULL pointer.
41
42       [1mSENOSHOST    [22mHost unknown.
43
44       [1mSENOSSERV    [22mService unknown.
45
46       [1mSECOMERR     [22mCommunication error.
47
48       [1mENSNACT      [22mName server is not running or is being
49shutdown.
50
51
52
53DPNS                        $Date:    2007/05/09    06:38:31    $
54DPNS_PING(3)
55
56
57
58
59
60
61
62
63
64
65
66
Impressum