- NAME
-
mslplib_testagent - simple user agent test program
- SYNOPSIS
-
mslplib_testagent [-f filename] [-c filename] [-q]
- AVAILABILITY
-
This utility has been ported to Solaris 2.4 and higher,
Linux 2.0 and higher and Windows NT 4.0 and higher.
- DESCRIPTION
-
mslplib_testagent is a simple interpreter which reads a series
of commands from standard input. It executes these commands
synchronously (blocking till each one is complete). It then
outputs the result to standard output.
mslplib_testagent does active DA discovery when it starts. This
results in a delay during initialization.
The commands available to the interpeter are as follows:
| Command | Arguments | Definition |
|---|
| service |
<lang> <request> |
- lang
- An RFC 1766 Language Tag. For example, "en".
- request
- A '/' delimited request. The first term is the
service type sought. The second term is the scope
to use for the request. The final term is the LDAPv3
search filter to use to select services.
For example,
"service:printer:ipp/default/(paper-color=yellow)/"
|
| attr |
<lang> <t> <s> <<tl>> |
- lang
- The 'lang' is an RFC 1766 Language Tag.
- 't'
- This is either a service type (like service:printer)
or a full URL (like service:printer:lpr://srv:512/queue
and so on.)
The former returs attributes for all
printers, the latter only for the named printer.
- 's'
- This is the scope list. The
scope list a,b,c returns attributes for scopes in
scopes a, b and c.
- 'tl'
- This is the tag list of attributes to return. For
example "a*,*b*,*c,d*d" returns attributes whose tags
begin in
a, ending in c, containing a b or beginning and ending with
d. Matching is case insensitive.
|
| type |
<s> <$lt;na>> |
- 's'
- This is the scope list. The
scope list a,b,c returns service types for scopes in
scopes a, b and c.
- 'na'
- This naming authority string. If blank, it the
request will return values in the default IANA naming
authority. If '*' all services, irrespective of naming
authority are returned.
|
| scope |
<<srvtype>> |
This returns the scopes available for making a request.
Optionally supply the service type of the request which
will be made.
If mslplib was compiled with SADISC support, and
ther are no SLP Directory Agents this function may block
for a 'net.slp.multicastMaximumWait' seconds.
|
| expect |
< text > |
Outputs the text. This is useful for annotating the output
of mslplib_testagent when it is run from an input file.
|
| sleep |
<msec> |
This causes mslplib_testagent to block for the supplied
number of milliseconds.
|
| get |
<prop> |
This returns the value of the property named. For instance,
net.slp.locale is the Language Tag used in requests. By
default, this is set to "en".
|
| set |
<prop> <<val>> |
This allows a property to be set via a command. For example,
to set the Language tag to Spanish:
set^net.slp.locale^es^
The value is optional. If the value is omitted, this removes
the property. Caution: Certain properties are required for
the slp implementation to function.
|
| exit |
|
Exits the test. |
- OPTIONS
-
- -f filename
-
Read input from filename instead of standard input.
- -c filename
-
Read the configuration file filename. This allows
nonstandard properties to be configured for mslplib_testagent.
Otherwise, the default configuration is used.
- -q
-
Quiet mode. In this case do not echo the commands. The
default is to echo commands before execution.
- ENVIRONMENT
-
If mslplib_testagent is executed on Windows NT, the PATH environment
variable must include the directory which includes both mslplib_tesatagent
and mslplib.dll.
The shared library libslp.so must be included on the LD_LIBRARY_PATH
in order for mslplib_testagent to load.
Otherwise, no environment variables or path information is used by
mslplib_testagent.
- SEE ALSO
-
See Mini SLP Configuration for
details on configurable properties. For information on the
functions being exercised, see
the SLP API.
For the syntax of service requests, language tags, scopes, etc.
see the SLPv2
specification. For a list of current known defects see the
README .
- NOTES
-
The text input format allows most functions of the Mini SLP
implementation to be exercised. Since '^' is used in the
interpreter, this character cannot be used in service requests.
An example service request is:
service^en-BR^service:talkd/default/(&(user=tom)(auth=sasl-otp))/^
This requests a talkd service (in the British dialect of English)
which can connect me to user 'tom' which will authenticate the
parties using the OTP SASL mechanism.
|
