xref: /illumos-gate/usr/src/lib/pkcs11/pkcs11_tpm/common/hwf_obj.c (revision 20a7641f9918de8574b8b3b47dbe35c4bfc78df1)
1 /*
2  *		Common Public License Version 0.5
3  *
4  *		THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF
5  *		THIS COMMON PUBLIC LICENSE ("AGREEMENT"). ANY USE,
6  *		REPRODUCTION OR DISTRIBUTION OF THE PROGRAM CONSTITUTES
7  *		RECIPIENT'S ACCEPTANCE OF THIS AGREEMENT.
8  *
9  *		1. DEFINITIONS
10  *
11  *		"Contribution" means:
12  *			a) in the case of the initial Contributor, the
13  *			initial code and documentation distributed under
14  *			this Agreement, and
15  *
16  *			b) in the case of each subsequent Contributor:
17  *			i) changes to the Program, and
18  *			ii) additions to the Program;
19  *
20  *			where such changes and/or additions to the Program
21  *			originate from and are distributed by that
22  *			particular Contributor. A Contribution 'originates'
23  *			from a Contributor if it was added to the Program
24  *			by such Contributor itself or anyone acting on such
25  *			Contributor's behalf. Contributions do not include
26  *			additions to the Program which: (i) are separate
27  *			modules of software distributed in conjunction with
28  *			the Program under their own license agreement, and
29  *			(ii) are not derivative works of the Program.
30  *
31  *
32  *		"Contributor" means any person or entity that distributes
33  *		the Program.
34  *
35  *		"Licensed Patents " mean patent claims licensable by a
36  *		Contributor which are necessarily infringed by the use or
37  *		sale of its Contribution alone or when combined with the
38  *		Program.
39  *
40  *		"Program" means the Contributions distributed in
41  *		accordance with this Agreement.
42  *
43  *		"Recipient" means anyone who receives the Program under
44  *		this Agreement, including all Contributors.
45  *
46  *		2. GRANT OF RIGHTS
47  *
48  *			a) Subject to the terms of this Agreement, each
49  *			Contributor hereby grants Recipient a
50  *			no - exclusive, worldwide, royalt - free copyright
51  *			license to reproduce, prepare derivative works of,
52  *			publicly display, publicly perform, distribute and
53  *			sublicense the Contribution of such Contributor, if
54  *			any, and such derivative works, in source code and
55  *			object code form.
56  *
57  *			b) Subject to the terms of this Agreement, each
58  *			Contributor hereby grants Recipient a
59  *			no - exclusive, worldwide, royalt - free patent
60  *			license under Licensed Patents to make, use, sell,
61  *			offer to sell, import and otherwise transfer the
62  *			Contribution of such Contributor, if any, in source
63  *			code and object code form. This patent license
64  *			shall apply to the combination of the Contribution
65  *			and the Program if, at the time the Contribution is
66  *			added by the Contributor, such addition of the
67  *			Contribution causes such combination to be covered
68  *			by the Licensed Patents. The patent license shall
69  *			not apply to any other combinations which include
70  *			the Contribution. No hardware per se is licensed
71  *			hereunder.
72  *
73  *			c) Recipient understands that although each
74  *			Contributor grants the licenses to its
75  *			Contributions set forth herein, no assurances are
76  *			provided by any Contributor that the Program does
77  *			not infringe the patent or other intellectual
78  *			property rights of any other entity. Each
79  *			Contributor disclaims any liability to Recipient
80  *			for claims brought by any other entity based on
81  *			infringement of intellectual property rights or
82  *			otherwise. As a condition to exercising the rights
83  *			and licenses granted hereunder, each Recipient
84  *			hereby assumes sole responsibility to secure any
85  *			other intellectual property rights needed, if any.
86  *
87  *			For example, if a third party patent license is
88  *			required to allow Recipient to distribute the
89  *			Program, it is Recipient's responsibility to
90  *			acquire that license before distributing the
91  *			Program.
92  *
93  *			d) Each Contributor represents that to its
94  *			knowledge it has sufficient copyright rights in its
95  *			Contribution, if any, to grant the copyright
96  *			license set forth in this Agreement.
97  *
98  *		3. REQUIREMENTS
99  *
100  *		A Contributor may choose to distribute the Program in
101  *		object code form under its own license agreement, provided
102  *		that:
103  *			a) it complies with the terms and conditions of
104  *			this Agreement; and
105  *
106  *			b) its license agreement:
107  *			i) effectively disclaims on behalf of all
108  *			Contributors all warranties and conditions, express
109  *			and implied, including warranties or conditions of
110  *			title and no - infringement, and implied warranties
111  *			or conditions of merchantability and fitness for a
112  *			particular purpose;
113  *
114  *			ii) effectively excludes on behalf of all
115  *			Contributors all liability for damages, including
116  *			direct, indirect, special, incidental and
117  *			consequential damages, such as lost profits;
118  *
119  *			iii) states that any provisions which differ from
120  *			this Agreement are offered by that Contributor
121  *			alone and not by any other party; and
122  *
123  *			iv) states that source code for the Program is
124  *			available from such Contributor, and informs
125  *			licensees how to obtain it in a reasonable manner
126  *			on or through a medium customarily used for
127  *			software exchange.
128  *
129  *		When the Program is made available in source code form:
130  *			a) it must be made available under this Agreement;
131  *			and
132  *			b) a copy of this Agreement must be included with
133  *			each copy of the Program.
134  *
135  *		Contributors may not remove or alter any copyright notices
136  *		contained within the Program.
137  *
138  *		Each Contributor must identify itself as the originator of
139  *		its Contribution, if any, in a manner that reasonably
140  *		allows subsequent Recipients to identify the originator of
141  *		the Contribution.
142  *
143  *
144  *		4. COMMERCIAL DISTRIBUTION
145  *
146  *		Commercial distributors of software may accept certain
147  *		responsibilities with respect to end users, business
148  *		partners and the like. While this license is intended to
149  *		facilitate the commercial use of the Program, the
150  *		Contributor who includes the Program in a commercial
151  *		product offering should do so in a manner which does not
152  *		create potential liability for other Contributors.
153  *		Therefore, if a Contributor includes the Program in a
154  *		commercial product offering, such Contributor ("Commercial
155  *		Contributor") hereby agrees to defend and indemnify every
156  *		other Contributor ("Indemnified Contributor") against any
157  *		losses, damages and costs (collectively "Losses") arising
158  *		from claims, lawsuits and other legal actions brought by a
159  *		third party against the Indemnified Contributor to the
160  *		extent caused by the acts or omissions of such Commercial
161  *		Contributor in connection with its distribution of the
162  *		Program in a commercial product offering. The obligations
163  *		in this section do not apply to any claims or Losses
164  *		relating to any actual or alleged intellectual property
165  *		infringement. In order to qualify, an Indemnified
166  *		Contributor must: a) promptly notify the Commercial
167  *		Contributor in writing of such claim, and b) allow the
168  *		Commercial Contributor to control, and cooperate with the
169  *		Commercial Contributor in, the defense and any related
170  *		settlement negotiations. The Indemnified Contributor may
171  *		participate in any such claim at its own expense.
172  *
173  *
174  *		For example, a Contributor might include the Program in a
175  *		commercial product offering, Product X. That Contributor
176  *		is then a Commercial Contributor. If that Commercial
177  *		Contributor then makes performance claims, or offers
178  *		warranties related to Product X, those performance claims
179  *		and warranties are such Commercial Contributor's
180  *		responsibility alone. Under this section, the Commercial
181  *		Contributor would have to defend claims against the other
182  *		Contributors related to those performance claims and
183  *		warranties, and if a court requires any other Contributor
184  *		to pay any damages as a result, the Commercial Contributor
185  *		must pay those damages.
186  *
187  *
188  *		5. NO WARRANTY
189  *
190  *		EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE
191  *		PROGRAM IS PROVIDED ON AN "AS IS" BASIS, WITHOUT
192  *		WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR
193  *		IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR
194  *		CONDITIONS OF TITLE, NO - INFRINGEMENT, MERCHANTABILITY OR
195  *		FITNESS FOR A PARTICULAR PURPOSE. Each Recipient is solely
196  *		responsible for determining the appropriateness of using
197  *		and distributing the Program and assumes all risks
198  *		associated with its exercise of rights under this
199  *		Agreement, including but not limited to the risks and
200  *		costs of program errors, compliance with applicable laws,
201  *		damage to or loss of data, programs or equipment, and
202  *		unavailability or interruption of operations.
203  *
204  *		6. DISCLAIMER OF LIABILITY
205  *		EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER
206  *		RECIPIENT NOR ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY
207  *		FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
208  *		OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION
209  *		LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF
210  *		LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
211  *		(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
212  *		OF THE USE OR DISTRIBUTION OF THE PROGRAM OR THE EXERCISE
213  *		OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF ADVISED OF THE
214  *		POSSIBILITY OF SUCH DAMAGES.
215  *
216  *		7. GENERAL
217  *
218  *		If any provision of this Agreement is invalid or
219  *		unenforceable under applicable law, it shall not affect
220  *		the validity or enforceability of the remainder of the
221  *		terms of this Agreement, and without further action by the
222  *		parties hereto, such provision shall be reformed to the
223  *		minimum extent necessary to make such provision valid and
224  *		enforceable.
225  *
226  *
227  *		If Recipient institutes patent litigation against a
228  *		Contributor with respect to a patent applicable to
229  *		software (including a cros - claim or counterclaim in a
230  *		lawsuit), then any patent licenses granted by that
231  *		Contributor to such Recipient under this Agreement shall
232  *		terminate as of the date such litigation is filed. In
233  *		addition, If Recipient institutes patent litigation
234  *		against any entity (including a cros - claim or
235  *		counterclaim in a lawsuit) alleging that the Program
236  *		itself (excluding combinations of the Program with other
237  *		software or hardware) infringes such Recipient's
238  *		patent(s), then such Recipient's rights granted under
239  *		Section 2(b) shall terminate as of the date such
240  *		litigation is filed.
241  *
242  *		All Recipient's rights under this Agreement shall
243  *		terminate if it fails to comply with any of the material
244  *		terms or conditions of this Agreement and does not cure
245  *		such failure in a reasonable period of time after becoming
246  *		aware of such noncompliance. If all Recipient's rights
247  *		under this Agreement terminate, Recipient agrees to cease
248  *		use and distribution of the Program as soon as reasonably
249  *		practicable. However, Recipient's obligations under this
250  *		Agreement and any licenses granted by Recipient relating
251  *		to the Program shall continue and survive.
252  *
253  *		Everyone is permitted to copy and distribute copies of
254  *		this Agreement, but in order to avoid inconsistency the
255  *		Agreement is copyrighted and may only be modified in the
256  *		following manner. The Agreement Steward reserves the right
257  *		to publish new versions (including revisions) of this
258  *		Agreement from time to time. No one other than the
259  *		Agreement Steward has the right to modify this Agreement.
260  *
261  *		IBM is the initial Agreement Steward. IBM may assign the
262  *		responsibility to serve as the Agreement Steward to a
263  *		suitable separate entity. Each new version of the
264  *		Agreement will be given a distinguishing version number.
265  *		The Program (including Contributions) may always be
266  *		distributed subject to the version of the Agreement under
267  *		which it was received. In addition, after a new version of
268  *		the Agreement is published, Contributor may elect to
269  *		distribute the Program (including its Contributions) under
270  *		the new version. Except as expressly stated in Sections
271  *		2(a) and 2(b) above, Recipient receives no rights or
272  *		licenses to the intellectual property of any Contributor
273  *		under this Agreement, whether expressly, by implication,
274  *		estoppel or otherwise. All rights in the Program not
275  *		expressly granted under this Agreement are reserved.
276  *
277  *
278  *		This Agreement is governed by the laws of the State of New
279  *		York and the intellectual property laws of the United
280  *		States of America. No party to this Agreement will bring a
281  *		legal action under this Agreement more than one year after
282  *		the cause of action arose. Each party waives its rights to
283  *		a jury trial in any resulting litigation.
284  *
285  *
286  *
287  * (C) COPYRIGHT International Business Machines Corp. 2001, 2002
288  */
289 /*
290  * Copyright 2009 Sun Microsystems, Inc.  All rights reserved.
291  * Use is subject to license terms.
292  */
293 #include "tpmtok_int.h"
294 
295 CK_RV
296 hwf_object_check_required_attributes(TEMPLATE *tmpl, CK_ULONG mode)
297 {
298 	CK_ATTRIBUTE * attr = NULL;
299 	CK_BBOOL    found;
300 
301 	found = template_attribute_find(tmpl, CKA_HW_FEATURE_TYPE, &attr);
302 	if (! found) {
303 		if (mode == MODE_CREATE) {
304 			return (CKR_TEMPLATE_INCOMPLETE);
305 		}
306 	}
307 
308 	return (template_check_required_base_attributes(tmpl, mode));
309 }
310 
311 CK_RV
312 clock_check_required_attributes(TEMPLATE *tmpl, CK_ULONG mode)
313 {
314 	CK_ATTRIBUTE *attr = NULL;
315 	CK_BBOOL	found;
316 
317 	if (mode == MODE_CREATE) {
318 		found = template_attribute_find(tmpl, CKA_VALUE, &attr);
319 		if (! found) {
320 			return (CKR_TEMPLATE_INCOMPLETE);
321 		}
322 	}
323 
324 	return (hwf_object_check_required_attributes(tmpl, mode));
325 }
326 
327 CK_RV
328 counter_check_required_attributes(TEMPLATE *tmpl, CK_ULONG mode)
329 {
330 	CK_ATTRIBUTE *attr = NULL;
331 	CK_BBOOL	found;
332 
333 	if (mode == MODE_CREATE) {
334 		found = template_attribute_find(tmpl, CKA_VALUE, &attr);
335 		if (! found) {
336 			return (CKR_TEMPLATE_INCOMPLETE);
337 		}
338 
339 		found = template_attribute_find(tmpl, CKA_HAS_RESET, &attr);
340 		if (! found) {
341 			return (CKR_TEMPLATE_INCOMPLETE);
342 		}
343 
344 		found = template_attribute_find(tmpl, CKA_RESET_ON_INIT, &attr);
345 		if (! found) {
346 			return (CKR_TEMPLATE_INCOMPLETE);
347 		}
348 	}
349 
350 	return (hwf_object_check_required_attributes(tmpl, mode));
351 }
352 
353 
354 // hwf_object_validate_attribute()
355 //
356 CK_RV
357 hwf_validate_attribute(TEMPLATE *tmpl, CK_ATTRIBUTE *attr, CK_ULONG mode)
358 {
359 	switch (attr->type) {
360 		case CKA_HW_FEATURE_TYPE:
361 		if (mode == MODE_CREATE)
362 			return (CKR_OK);
363 		else
364 			return (CKR_ATTRIBUTE_READ_ONLY);
365 
366 		default:
367 			return (template_validate_base_attribute(tmpl,
368 			    attr, mode));
369 	}
370 }
371 
372 CK_RV
373 clock_validate_attribute(TEMPLATE *tmpl, CK_ATTRIBUTE *attr, CK_ULONG mode) {
374 	switch (attr->type) {
375 		case CKA_VALUE:
376 		return (CKR_OK);
377 
378 		default:
379 		return (hwf_validate_attribute(tmpl, attr, mode));
380 	}
381 }
382 
383 CK_RV
384 counter_validate_attribute(TEMPLATE *tmpl, CK_ATTRIBUTE *attr, CK_ULONG mode)
385 {
386 	switch (attr->type) {
387 		case CKA_VALUE:
388 		/* Fall Through */
389 		case CKA_HAS_RESET:
390 		/* Fall Through */
391 		case CKA_RESET_ON_INIT:
392 		return (CKR_ATTRIBUTE_READ_ONLY);
393 
394 		default:
395 		return (hwf_validate_attribute(tmpl, attr, mode));
396 	}
397 }
398 
399 
400 CK_RV
401 clock_set_default_attributes(TEMPLATE *tmpl)
402 {
403 	CK_ATTRIBUTE		*value_attr;
404 
405 	value_attr = (CK_ATTRIBUTE *)malloc(sizeof (CK_ATTRIBUTE));
406 
407 	if (! value_attr) {
408 		return (CKR_HOST_MEMORY);
409 	}
410 
411 	value_attr->type	= CKA_VALUE;
412 	value_attr->ulValueLen = 0;
413 	value_attr->pValue	= NULL;
414 
415 	(void) template_update_attribute(tmpl, value_attr);
416 
417 	return (CKR_OK);
418 }
419 
420 CK_RV
421 counter_set_default_attributes(TEMPLATE *tmpl)
422 {
423 	CK_ATTRIBUTE	 *value_attr;
424 	CK_ATTRIBUTE	 *hasreset_attr;
425 	CK_ATTRIBUTE	 *resetoninit_attr;
426 
427 	value_attr = (CK_ATTRIBUTE *)malloc(sizeof (CK_ATTRIBUTE));
428 	hasreset_attr = (CK_ATTRIBUTE *)malloc(sizeof (CK_ATTRIBUTE) +
429 	    sizeof (CK_BBOOL));
430 	resetoninit_attr = (CK_ATTRIBUTE *)malloc(sizeof (CK_ATTRIBUTE) +
431 	    sizeof (CK_BBOOL));
432 
433 	if (! value_attr || ! hasreset_attr || ! resetoninit_attr) {
434 		if (value_attr) free(value_attr);
435 		if (hasreset_attr) free(hasreset_attr);
436 		if (resetoninit_attr) free(resetoninit_attr);
437 		return (CKR_HOST_MEMORY);
438 	}
439 
440 	value_attr->type	= CKA_VALUE;
441 	value_attr->ulValueLen = 0;
442 	value_attr->pValue	= NULL;
443 
444 	hasreset_attr->type	= CKA_HAS_RESET;
445 	hasreset_attr->ulValueLen = sizeof (CK_BBOOL);
446 	hasreset_attr->pValue	= (CK_BYTE *)hasreset_attr +
447 	    sizeof (CK_ATTRIBUTE);
448 	*(CK_BBOOL *)hasreset_attr->pValue = FALSE;
449 
450 	/* Hmm...  Not sure if we should be setting this here. */
451 	resetoninit_attr->type	= CKA_RESET_ON_INIT;
452 	resetoninit_attr->ulValueLen = sizeof (CK_BBOOL);
453 	resetoninit_attr->pValue = (CK_BYTE *)resetoninit_attr +
454 	    sizeof (CK_ATTRIBUTE);
455 	*(CK_BBOOL *)resetoninit_attr->pValue = FALSE;
456 
457 	(void) template_update_attribute(tmpl, value_attr);
458 	(void) template_update_attribute(tmpl, hasreset_attr);
459 	(void) template_update_attribute(tmpl, resetoninit_attr);
460 
461 	return (CKR_OK);
462 }
463