1README
2
3Welcome to the wbemcli command line tool to access
4data hosted by a CIMOM .
5
6Please use the man page for further information .
7man wbemcli
8
9Available Command Aliases :
10
11wbemgi		GetInstance
12wbemein 	EnumInstanceNames
13wbemei		EnumInstances
14
15wbemci		CreateInstance
16wbemmi		ModifyInstance
17wbemdi		DeleteInstance
18
19wbemgc		GetClass
20wbemgcd		GetClass
21wbemdc		DeleteClass
22wbemec		EnumClasses
23wbemecn		EnumClassNames
24
25wbemai		Associators
26wbemain		AssociatorNames
27wbemri		References
28wbemrin		ReferenceNames
29
30wbemgp		GetProperty
31wbemsp		SetProperty
32
33wbemcm		InvokeMethod
34wbemcmx		InvokeMethod
35
36Usage :
37
38wbemcli gc|gcd|dc|ec|ecn|gi|ci|mi|di|ei|ein|ain|ai|rin|ri|gp|sp
39	        [-nl] [-dx] [-t] [-h] [-v]
40	        [-ac <assocClass>] [-arc <resultClass>] [-ar <role>] [-arr <resultRole>]
41	        <url> [<attrs>]
42	gc	get class
43	gcd	get class definition
44	dc	delete class
45	ec	enumerate class
46	ecn	enumerate class names
47	ci	create instance
48	mi	modify instance
49	di	delete instance
50	ec	enumerate instances
51	ecn	enumerate instance names
52	ain	associate instance names
53	ai	associate instances
54	rin	reference instance names
55	ri	reference instances
56	gp	get property
57	sp	set property
58	cm	call method
59	cmx     call method (returns XML)
60
61	-nl	one attribute per line
62	-dx	xml debugging
63	-t	add array([]) and ref(&) indications
64	-h	help
65	-v	version
66
67	-ac	 association class name (ai, ain only)
68	-arc	 result class name (ai, ain, rin, ri only)
69	-ar	 role name (ai, ain, rin, ri only)
70	-arr	 result role name (ai, ain only)
71
72	url	'<protocol>://[user:password@]<host>[:<port>]/<namespace[/..]>:<classname>[.<key=value[,..]>]'
73	attrs	'<name=value[,..]>' (required for ci and mi only)
74
75	Single quotes should be used around the url and attrs to perserve double
76	qouted strings. If not enclosed the double quotes will be striped by the
77	shell, and wbemcli will mistake string values starting with a digit/+/- as
78	numeric, or strings starting with 'true/false' as boolean.
79		example 'http://localhost:5988/root/cimv2:rpm_package.name="glibc",id=5'
80
81	Host indirection support: The string '<protocol>://[user:password@]<host>[:<port>]'
82	can be replaced by an arbitrary string. This string will be used to
83	locate the proper protocol and host specification in ./wbemcli.ind or
84	any file specified via the WBEMCLI_IND environment variable.
85	Format in ./wbemcli.ind is:
86		<string>: <protocol>://[user:password@]<host>[:<port>]
87
88BUILD Notes:
89
90See the INSTALL file. If checking out of CVS first run autoconfiscate.sh to
91setup the autotools.
92
93SSL Notes:
94
95Currently SSL (https) support is only working with libcurl. wbemcli supports
96both verification of the server and client certificate authentication.
97For server verification it is necessary to have access to a self signed
98certificate of the server or a CA certificate of the CA that issued the
99server's certificate in PEM format.
100There's no default location for this certificate: it must be specified with
101the -cacert option.
102The server certificate verification can be disabled with the -noverify option.
103If the server requires a client certificate, it can be specified with
104-clientcert in which case it is also necessary to specify the client's
105private key file with -clientkey. Both files must be in PEM format.
106
107BUGS:
108
109Authentication with libghttp is broken: incorrect user/password will cause a
110hang situation.
111
112Authentication with libwww is slightly broken: incorrect user/password will
113cause a meaningless error code.
114