File: utilities.tex

package info (click to toggle)
omniorb-dfsg 4.3.3%2Bds1-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 13,172 kB
  • sloc: cpp: 115,843; python: 24,962; ansic: 13,414; sh: 2,665; makefile: 40
file content (146 lines) | stat: -rw-r--r-- 3,222 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
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
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
\documentclass[11pt,oneside,a4paper]{article}
\usepackage[T1]{fontenc}
\usepackage{textcomp}
\usepackage[scaled=0.9]{DejaVuSansMono}
\usepackage[scaled=0.9]{DejaVuSans}
\usepackage[scaled=0.9]{DejaVuSerif}
\linespread{1.05}

\addtolength{\oddsidemargin}{-0.2in}
\addtolength{\evensidemargin}{-0.6in}
\addtolength{\textwidth}{0.5in}
\pagestyle{headings}

\title{The omniORB utilities}

\date{Version 4.3}

\begin{document}

\maketitle

\section{catior}
Usage:
\begin{verbatim}
catior [-x] <stringified IOR>
\end{verbatim}

\noindent catior is a utility for viewing components of a stringified
IOR.  It displays the components of the stringified object reference
supplied to it.

The options are:


\begin{tabular}{ll}
\verb.-x.
  & Display the object key in hexadecimal.
\end{tabular}


\section{genior}
Usage: 
\begin{verbatim}
genior [-x] <Type ID> <hostname> <port number> [object key]
\end{verbatim}

\noindent genior generates a stringified object reference from the
arguments supplied to it.  If an object key argument isn't supplied,
it will use an object key generated by omniORB2.

The options are:


\begin{tabular}{lp{.75\textwidth}}
\verb.-x.
 & Interpret the object key as a hexadecimal value. This 
value should begin with "0x"
\end{tabular}


\section{nameclt}
Usage: 
\begin{verbatim}
nameclt [-ior <object-reference>] [-advanced] <operation> 
\end{verbatim}

\noindent The nameclt command invokes operations on the Naming
Service.

\subsection{Operations}

The allowed operations are:

\begin{description}
\item \verb.list  <context-name>.

lists contexts and objects bound in the context with the specified name.

\item \verb.bind_new_context <context-name>.

binds name to a new context, and returns the stringified context IOR.

\item \verb.remove_context <context-name>.

unbinds and destroys the named context, as long as it is empty.

\item \verb.bind <object-name> <stringified-IOR>.

binds name to object.

\item \verb.unbind <object-name>.

unbinds name and object.

\item \verb.resolve  <object-name>.

returns stringified IOR bound to specified name.

\end{description}


\subsection{Options}

The options are:

\begin{description}

\item \verb.-ior <NameService-object-reference>.

Use the given stringified IOR as the "root" context of the naming service.  By
default, nameclt uses the object reference returned by calling: \\
\verb.CORBA::ORB::resolve_initial_references("NameService").

\item \verb.-advanced.

Allow advanced operations.  These are operations which should not normally need
to be used.  They may however be useful for testing the naming service and also
for cleaning up in the event of a client messing up the namespace.  The
operations are:

\begin{description}
\item \verb.bind_context <context-name> <stringified-IOR>.

binds name to context.

\item \verb.rebind <object-name> <stringified-IOR>.

binds name to object even if binding already exists.

\item \verb.rebind_context <context-name> <stringified-IOR>.

binds name to context even if binding already exists.

\item \verb.new_context.

returns stringified IOR for a new context.

\item \verb.destroy.

destroys the naming context given with \verb.-ior. flag.
\end{description}


\end{description}

\end{document}