equal
deleted
inserted
replaced
1 '\" te |
1 '\" te |
2 .\" Copyright (c) 2011, 2012, Oracle and/or its |
2 .\" Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. |
3 .\" affiliates. All rights reserved. |
3 .TH aimanifest 1M "19 Jun 2012" "SunOS 5.11" "System Administration Commands" |
4 .TH aimanifest 1M "04 May 2012" "SunOS 5.11" "System Administration Commands" |
|
5 .SH NAME |
4 .SH NAME |
6 aimanifest \- Modify an XML file used by Automated Installer (AI) |
5 aimanifest \- Modify an XML file used by Automated Installer (AI) |
7 .SH SYNOPSIS |
6 .SH SYNOPSIS |
8 .LP |
7 .LP |
9 .nf |
8 .nf |
71 .ne 2 |
70 .ne 2 |
72 .mk |
71 .mk |
73 .na |
72 .na |
74 \fB\fB-h\fR, \fB--help\fR\fR |
73 \fB\fB-h\fR, \fB--help\fR\fR |
75 .ad |
74 .ad |
76 .RS 14n |
75 .sp .6 |
77 .rt |
76 .RS 4n |
78 Show the usage help message. |
77 Show the usage help message. |
79 .RE |
78 .RE |
80 |
79 |
81 .sp |
80 .sp |
82 .LP |
81 .LP |
85 .ne 2 |
84 .ne 2 |
86 .mk |
85 .mk |
87 .na |
86 .na |
88 \fB\fB-r\fR, \fB--return-path\fR\fR |
87 \fB\fB-r\fR, \fB--return-path\fR\fR |
89 .ad |
88 .ad |
90 .RS 21n |
89 .sp .6 |
91 .rt |
90 .RS 4n |
92 Return the path of the XML element that this \fBaimanifest\fR command creates or operates on. This returned path is a chain of node IDs. You can save this returned path value to use in subsequent calls to \fBaimanifest\fR. Using the path returned by the \fB-r\fR option is more reliable than specifying the path using XML element and attribute values, since the values can change as the AI manifest is being built. See the "Return Paths" section for more information about the path returned by the \fB-r\fR option. |
91 Return the path of the XML element that this \fBaimanifest\fR command creates or operates on. This returned path is a chain of node IDs. You can save this returned path value to use in subsequent calls to \fBaimanifest\fR. Using the path returned by the \fB-r\fR option is more reliable than specifying the path using XML element and attribute values, since the values can change as the AI manifest is being built. See the "Return Paths" section for more information about the path returned by the \fB-r\fR option. |
93 .RE |
92 .RE |
94 |
93 |
95 .sp |
94 .sp |
96 .LP |
95 .LP |
99 .ne 2 |
98 .ne 2 |
100 .mk |
99 .mk |
101 .na |
100 .na |
102 \fB\fB-i\fR, \fB--incremental\fR\fR |
101 \fB\fB-i\fR, \fB--incremental\fR\fR |
103 .ad |
102 .ad |
104 .RS 21n |
103 .sp .6 |
105 .rt |
104 .RS 4n |
106 Do not clear the \fBAIM_MANIFEST\fR data before adding new data. |
105 Do not clear the \fBAIM_MANIFEST\fR data before adding new data. |
107 .RE |
106 .RE |
108 |
107 |
109 .SH SUB-COMMANDS |
108 .SH SUB-COMMANDS |
110 .sp |
109 .sp |
112 The following subcommands are supported: |
111 The following subcommands are supported: |
113 .sp |
112 .sp |
114 .ne 2 |
113 .ne 2 |
115 .mk |
114 .mk |
116 .na |
115 .na |
117 \fB\fBadd [\fB-r\fR | \fB--return-path\fR] \fIpath\fR \fIvalue\fR\fR\fR |
116 \fB\fBaimanifest add [-r | --return-path] \fIpath\fR \fIvalue\fR\fR\fR |
118 .ad |
117 .ad |
119 .sp .6 |
118 .sp .6 |
120 .RS 4n |
119 .RS 4n |
121 Add a new element to an XML manifest. Add the new element at \fIpath\fR and with value \fIvalue\fR. See the "Operands" section for more information about \fIpath\fR. If \fIpath\fR ends in an attribute (\fB@\fIattr\fR\fR), then the new element has the \fIattr\fR attribute, and \fIvalue\fR is the value of the attribute. |
120 Add a new element to an XML manifest. Add the new element at \fIpath\fR and with value \fIvalue\fR. See the "Operands" section for more information about \fIpath\fR. If \fIpath\fR ends in an attribute (\fB@\fIattr\fR\fR), then the new element has the \fIattr\fR attribute, and \fIvalue\fR is the value of the attribute. |
122 .sp |
121 .sp |
174 |
173 |
175 .sp |
174 .sp |
176 .ne 2 |
175 .ne 2 |
177 .mk |
176 .mk |
178 .na |
177 .na |
179 \fB\fBget [\fB-r\fR | \fB--return-path\fR] \fIpath\fR\fR\fR |
178 \fB\fBaimanifest get [-r | --return-path] \fIpath\fR\fR\fR |
180 .ad |
179 .ad |
181 .sp .6 |
180 .sp .6 |
182 .RS 4n |
181 .RS 4n |
183 Retrieve an element or attribute value. An empty string (\fB""\fR) is displayed for empty element or attribute values. The \fIpath\fR must match a unique existing element or attribute. See the "Operands" section for more information about \fIpath\fR. |
182 Retrieve an element or attribute value. An empty string (\fB""\fR) is displayed for empty element or attribute values. The \fIpath\fR must match a unique existing element or attribute. See the "Operands" section for more information about \fIpath\fR. |
184 .sp |
183 .sp |
187 |
186 |
188 .sp |
187 .sp |
189 .ne 2 |
188 .ne 2 |
190 .mk |
189 .mk |
191 .na |
190 .na |
192 \fB\fBset [\fB-r\fR | \fB--return-path\fR] \fIpath\fR \fIvalue\fR\fR\fR |
191 \fB\fBaimanifest set [-r | --return-path] \fIpath\fR \fIvalue\fR\fR\fR |
193 .ad |
192 .ad |
194 .sp .6 |
193 .sp .6 |
195 .RS 4n |
194 .RS 4n |
196 Change the value of an existing element or attribute, or create a new attribute of an existing element. No validation is performed. |
195 Change the value of an existing element or attribute, or create a new attribute of an existing element. No validation is performed. |
197 .sp |
196 .sp |
204 |
203 |
205 .sp |
204 .sp |
206 .ne 2 |
205 .ne 2 |
207 .mk |
206 .mk |
208 .na |
207 .na |
209 \fB\fBload [\fB-i\fR | \fB--incremental\fR] \fIfilename\fR\fR\fR |
208 \fB\fBaimanifest load [-i | --incremental] \fIfilename\fR\fR\fR |
210 .ad |
209 .ad |
211 .sp .6 |
210 .sp .6 |
212 .RS 4n |
211 .RS 4n |
213 Load an XML manifest or partial XML manifest from the file \fIfilename\fR. No validation is performed except to examine parent/child relationships of elements. |
212 Load an XML manifest or partial XML manifest from the file \fIfilename\fR. No validation is performed except to examine parent/child relationships of elements. |
214 .sp |
213 .sp |
313 |
312 |
314 .sp |
313 .sp |
315 .ne 2 |
314 .ne 2 |
316 .mk |
315 .mk |
317 .na |
316 .na |
318 \fB\fBvalidate\fR\fR |
317 \fB\fBaimanifest validate\fR\fR |
319 .ad |
318 .ad |
320 .sp .6 |
319 .sp .6 |
321 .RS 4n |
320 .RS 4n |
322 Validates the \fBAIM_MANIFEST\fR manifest against the DTD referenced in the \fB!DOCTYPE\fR statement. Errors are printed to \fBstderr\fR. A non-zero status is returned if validation fails. |
321 Validates the \fBAIM_MANIFEST\fR manifest against the DTD referenced in the \fB!DOCTYPE\fR statement. Errors are printed to \fBstderr\fR. A non-zero status is returned if validation fails. |
323 .RE |
322 .RE |
915 .ne 2 |
914 .ne 2 |
916 .mk |
915 .mk |
917 .na |
916 .na |
918 \fB\fBAIM_MANIFEST\fR\fR |
917 \fB\fBAIM_MANIFEST\fR\fR |
919 .ad |
918 .ad |
920 .RS 16n |
919 .sp .6 |
921 .rt |
920 .RS 4n |
922 The value of this environment variable is the location of the AI manifest that is being built. |
921 The value of this environment variable is the location of the AI manifest that is being built. |
923 .RE |
922 .RE |
924 |
923 |
925 .sp |
924 .sp |
926 .ne 2 |
925 .ne 2 |
927 .mk |
926 .mk |
928 .na |
927 .na |
929 \fB\fBAIM_LOGFILE\fR\fR |
928 \fB\fBAIM_LOGFILE\fR\fR |
930 .ad |
929 .ad |
931 .RS 16n |
930 .sp .6 |
932 .rt |
931 .RS 4n |
933 The value of this environment variable is the location of the log file of \fBaimanifest\fR operations. |
932 The value of this environment variable is the location of the log file of \fBaimanifest\fR operations. |
934 .RE |
933 .RE |
935 |
934 |
936 .SH ATTRIBUTES |
935 .SH ATTRIBUTES |
937 .sp |
936 .sp |
955 .TE |
954 .TE |
956 |
955 |
957 .SH SEE ALSO |
956 .SH SEE ALSO |
958 .sp |
957 .sp |
959 .LP |
958 .LP |
960 installadm(1M), \fBpkg\fR(1) |
959 \fBinstalladm\fR(1M) |
961 .sp |
960 .sp |
962 .LP |
961 .LP |
963 Part\ III, \fIInstalling Using an Install Server,\fR in \fIInstalling Oracle Solaris 11 Systems\fR |
962 Part\ III, \fIInstalling Using an Install Server,\fR in \fIInstalling Oracle Solaris 11 Systems\fR |