usr/src/lib/wiseman/wise.1
changeset 0 b34509ac961f
child 11 87960ed158f9
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/usr/src/lib/wiseman/wise.1	Wed Oct 21 17:43:30 2009 +0200
@@ -0,0 +1,93 @@
+'\" t
+.TH "wise" "1" "" "" ""
+.SH NAME
+wise - a command line tool for sending requests to WS-Management Web services.
+.SH SYNOPSIS
+.B wise
+[OPTIONS]
+.SH DESCRIPTION
+The WisemanCmdLine command line tool provides a simple method for sending requests to WS-Management Web services for testing. Get, Put, Create, Delete, and optimized Enumeration are currently supported. The script 'wise' located at /usr/bin can be used to call the WisemanCmdLine class with the necessary classpath. The tools usage follows. 
+.P
+.B
+Usage: wise -a -d -r [ -s | -b | -x | -m | -u | -p ]
+
+.P
+.B
+[OPTIONS]
+-a WS-MAN action to perform (get, put, create, delete, enumeration).  This argument is required.
+
+-d URL destination for the Wiseman request.   This argument is required.
+
+-r Resource URI value of the Wiseman request.   This argument is required.
+
+-s Name and value for the item requested.  The first value is the name of the "key" field, the second is the value of the "key" field.
+
+-b File name of the XML body of the request.  The file must contain valid XML.  This argument is required for Create and Put requests.
+
+-x XPATH expression to apply to result set.  This argument is used for a fragment transfer request.
+
+-m Maximum number of items to return.  This argument is valid only for Enumeration requests.
+
+-u User name to connect to the web service.
+
+-p Password to connect to the web service.
+
+.P
+.B
+Sample usage
+
+Create
+wise  -a create -r "urn:resources.wiseman.dev.java.net/traffic/1/light" -d "http://localhost:8080/traffic/" -b "C:\Documents and Settings\nabee\My Documents\create.txt"  -u wsman -p wsman
+
+Get
+wise  -a get -d "http://localhost
+:8080/traffic/"  -r "urn:resources.wiseman.dev.java.net/traffic/1/light" -s name
+ Light1
+
+Get (with fragment transfer)
+wise -a get -r "urn:resources.wiseman.dev.java.net/traffic/1/light" -d "http://localhost:8080/traffic/" -s name Light1 -x "//*[local-name()='color']"  -u wsman -p wsman
+
+Put
+wise  -a put -d "http://localhost
+:8080/traffic/"  -r "urn:resources.wiseman.dev.java.net/traffic/1/light" -s name
+ Light1 -b "c:\putbody.xml"
+
+Delete
+wise -a delete -r "urn:resources.wiseman.dev.java.net/traffic/1/light" -d "http://localhost:8080/traffic/" -s name Light1  -u wsman -p wsman
+
+Enumerate
+wise -a enumerate -r "urn:resources.wiseman.dev.java.net/traffic/1/light" -d "http://localhost:8080/traffic/" -m 10  -u wsman -p wsman
+
+.PP
+For more details about Wiseman, please see
+.br
+.B https://wiseman.dev.java.net web page.
+
+.SH FILES
+By default, all wise tool is installed into /usr/bin directory.
+
+.SH ENVIRONMENT
+JAVA_HOME variable must point to the directory where Java is installed.
+
+.RE
+.SH ATTRIBUTES
+See
+.BR attributes (5)
+for descriptions of the following attributes:
+.sp
+.TS
+box;
+cbp-1 | cbp-1
+l | l .
+ATTRIBUTE TYPE	ATTRIBUTE VALUE
+=
+Availability	SUNWwisemanu
+=
+Interface Stability	Uncommitted
+.TE
+.PP
+.SH SEE ALSO
+.LP
+wiseman(3)
+.SH NOTES
+Source for wiseman is available on http://opensolaris.org.