← Back to branch summary

~ubuntu-branches/debian/experimental/ion/experimental

« back to all changes in this revision

Viewing changes to bp/doc/pod1/dtn2adminep.pod

  • Committer: Package Import Robot
  • Author(s): Leo Iannacone
  • Date: 2012-02-01 09:46:31 UTC
  • Revision ID: package-import@ubuntu.com-20120201094631-qpfwehc1b7ftkjgx
Tags: upstream-2.5.3~dfsg1
Import upstream version 2.5.3~dfsg1

Show diffs side-by-side

added added

removed removed

Lines of Context:
bp/doc/pod1/dtn2adminep.pod
 
1
=head1 NAME
 
2
 
 
3
dtn2adminep - administrative endpoint task for the "dtn" scheme
 
4
 
 
5
=head1 SYNOPSIS
 
6
 
 
7
B<dtn2adminep>
 
8
 
 
9
=head1 DESCRIPTION
 
10
 
 
11
B<dtn2adminep> is a background "daemon" task that receives and processes
 
12
administrative bundles (all custody signals and, nominally, all bundle
 
13
status reports) that are sent to the "dtn"-scheme administrative endpoint
 
14
on the local ION node, if and only if such an endpoint was established by
 
15
B<bpadmin>.  It is spawned automatically by B<bpadmin> in response to the
 
16
's' (START) command that starts operation of Bundle Protocol on the local
 
17
ION node, and it is terminated by B<bpadmin> in response to an 'x' (STOP)
 
18
command.  B<dtn2adminep> can also be spawned and terminated in response to
 
19
START and STOP commands that pertain specifically to the "dtn" scheme.
 
20
 
 
21
B<dtn2adminep> responds to custody signals as specified in the Bundle
 
22
Protocol specification, RFC 5050.  It responds to bundle status reports
 
23
by logging ASCII text messages describing the reported activity.
 
24
 
 
25
=head1 EXIT STATUS
 
26
 
 
27
=over 4
 
28
 
 
29
=item 0
 
30
 
 
31
B<dtn2adminep> terminated, for reasons noted in the B<ion.log> file.  If this
 
32
termination was not commanded, investigate and solve the problem identified
 
33
in the log file and use B<bpadmin> to restart B<dtn2adminep>.
 
34
 
 
35
=item 1
 
36
 
 
37
B<dtn2adminep> was unable to attach to Bundle Protocol operations or was
 
38
unable to load the "dtn" scheme database, probably because B<bpadmin> has
 
39
not yet been run.
 
40
 
 
41
=back
 
42
 
 
43
=head1 FILES
 
44
 
 
45
No configuration files are needed.
 
46
 
 
47
=head1 ENVIRONMENT
 
48
 
 
49
No environment variables apply.
 
50
 
 
51
=head1 DIAGNOSTICS
 
52
 
 
53
The following diagnostics may be issued to the B<ion.log> log file:
 
54
 
 
55
=over 4
 
56
 
 
57
=item dtn2adminep can't attach to BP.
 
58
 
 
59
B<bpadmin> has not yet initialized BP operations.
 
60
 
 
61
=item dtn2adminep can't load routing database.
 
62
 
 
63
B<dtn2admin> has not yet initialized the "dtn" scheme.
 
64
 
 
65
=item dtn2adminep can't get admin EID.
 
66
 
 
67
B<dtn2admin> has not yet initialized the "dtn" scheme.
 
68
 
 
69
=item dtn2adminep crashed.
 
70
 
 
71
An unrecoverable database error was encountered.  B<dtn2adminep> terminates.
 
72
 
 
73
=back
 
74
 
 
75
=head1 BUGS
 
76
 
 
77
Report bugs to <ion-bugs@korgano.eecs.ohiou.edu>
 
78
 
 
79
=head1 SEE ALSO
 
80
 
 
81
bpadmin(1), dtn2admin(1).