TPM: sysfs functions consolidation
[GitHub/mt8127/android_kernel_alcatel_ttab.git] / drivers / char / tpm / tpm.c
CommitLineData
1da177e4
LT
1/*
2 * Copyright (C) 2004 IBM Corporation
3 *
4 * Authors:
5 * Leendert van Doorn <leendert@watson.ibm.com>
6 * Dave Safford <safford@watson.ibm.com>
7 * Reiner Sailer <sailer@watson.ibm.com>
8 * Kylene Hall <kjhall@us.ibm.com>
9 *
8e81cc13 10 * Maintained by: <tpmdd-devel@lists.sourceforge.net>
1da177e4
LT
11 *
12 * Device driver for TCG/TCPA TPM (trusted platform module).
13 * Specifications at www.trustedcomputinggroup.org
14 *
15 * This program is free software; you can redistribute it and/or
16 * modify it under the terms of the GNU General Public License as
17 * published by the Free Software Foundation, version 2 of the
18 * License.
19 *
20 * Note, the TPM chip is not interrupt driven (only polling)
21 * and can have very long timeouts (minutes!). Hence the unusual
700d8bdc 22 * calls to msleep.
1da177e4
LT
23 *
24 */
25
1da177e4 26#include <linux/poll.h>
d081d470 27#include <linux/mutex.h>
1da177e4 28#include <linux/spinlock.h>
25368ca5 29#include <linux/smp_lock.h>
d081d470 30
1da177e4
LT
31#include "tpm.h"
32
3122a88a
KH
33enum tpm_const {
34 TPM_MINOR = 224, /* officially assigned */
35 TPM_BUFSIZE = 2048,
36 TPM_NUM_DEVICES = 256,
3122a88a 37};
1da177e4 38
9e18ee19
KJH
39enum tpm_duration {
40 TPM_SHORT = 0,
41 TPM_MEDIUM = 1,
42 TPM_LONG = 2,
43 TPM_UNDEFINED,
44};
45
46#define TPM_MAX_ORDINAL 243
47#define TPM_MAX_PROTECTED_ORDINAL 12
48#define TPM_PROTECTED_ORDINAL_MASK 0xFF
49
1da177e4
LT
50static LIST_HEAD(tpm_chip_list);
51static DEFINE_SPINLOCK(driver_lock);
10685a95 52static DECLARE_BITMAP(dev_mask, TPM_NUM_DEVICES);
1da177e4 53
9e18ee19
KJH
54/*
55 * Array with one entry per ordinal defining the maximum amount
56 * of time the chip could take to return the result. The ordinal
57 * designation of short, medium or long is defined in a table in
58 * TCG Specification TPM Main Part 2 TPM Structures Section 17. The
59 * values of the SHORT, MEDIUM, and LONG durations are retrieved
60 * from the chip during initialization with a call to tpm_get_timeouts.
61 */
62static const u8 tpm_protected_ordinal_duration[TPM_MAX_PROTECTED_ORDINAL] = {
63 TPM_UNDEFINED, /* 0 */
64 TPM_UNDEFINED,
65 TPM_UNDEFINED,
66 TPM_UNDEFINED,
67 TPM_UNDEFINED,
68 TPM_UNDEFINED, /* 5 */
69 TPM_UNDEFINED,
70 TPM_UNDEFINED,
71 TPM_UNDEFINED,
72 TPM_UNDEFINED,
73 TPM_SHORT, /* 10 */
74 TPM_SHORT,
75};
76
77static const u8 tpm_ordinal_duration[TPM_MAX_ORDINAL] = {
78 TPM_UNDEFINED, /* 0 */
79 TPM_UNDEFINED,
80 TPM_UNDEFINED,
81 TPM_UNDEFINED,
82 TPM_UNDEFINED,
83 TPM_UNDEFINED, /* 5 */
84 TPM_UNDEFINED,
85 TPM_UNDEFINED,
86 TPM_UNDEFINED,
87 TPM_UNDEFINED,
88 TPM_SHORT, /* 10 */
89 TPM_SHORT,
90 TPM_MEDIUM,
91 TPM_LONG,
92 TPM_LONG,
93 TPM_MEDIUM, /* 15 */
94 TPM_SHORT,
95 TPM_SHORT,
96 TPM_MEDIUM,
97 TPM_LONG,
98 TPM_SHORT, /* 20 */
99 TPM_SHORT,
100 TPM_MEDIUM,
101 TPM_MEDIUM,
102 TPM_MEDIUM,
103 TPM_SHORT, /* 25 */
104 TPM_SHORT,
105 TPM_MEDIUM,
106 TPM_SHORT,
107 TPM_SHORT,
108 TPM_MEDIUM, /* 30 */
109 TPM_LONG,
110 TPM_MEDIUM,
111 TPM_SHORT,
112 TPM_SHORT,
113 TPM_SHORT, /* 35 */
114 TPM_MEDIUM,
115 TPM_MEDIUM,
116 TPM_UNDEFINED,
117 TPM_UNDEFINED,
118 TPM_MEDIUM, /* 40 */
119 TPM_LONG,
120 TPM_MEDIUM,
121 TPM_SHORT,
122 TPM_SHORT,
123 TPM_SHORT, /* 45 */
124 TPM_SHORT,
125 TPM_SHORT,
126 TPM_SHORT,
127 TPM_LONG,
128 TPM_MEDIUM, /* 50 */
129 TPM_MEDIUM,
130 TPM_UNDEFINED,
131 TPM_UNDEFINED,
132 TPM_UNDEFINED,
133 TPM_UNDEFINED, /* 55 */
134 TPM_UNDEFINED,
135 TPM_UNDEFINED,
136 TPM_UNDEFINED,
137 TPM_UNDEFINED,
138 TPM_MEDIUM, /* 60 */
139 TPM_MEDIUM,
140 TPM_MEDIUM,
141 TPM_SHORT,
142 TPM_SHORT,
143 TPM_MEDIUM, /* 65 */
144 TPM_UNDEFINED,
145 TPM_UNDEFINED,
146 TPM_UNDEFINED,
147 TPM_UNDEFINED,
148 TPM_SHORT, /* 70 */
149 TPM_SHORT,
150 TPM_UNDEFINED,
151 TPM_UNDEFINED,
152 TPM_UNDEFINED,
153 TPM_UNDEFINED, /* 75 */
154 TPM_UNDEFINED,
155 TPM_UNDEFINED,
156 TPM_UNDEFINED,
157 TPM_UNDEFINED,
158 TPM_LONG, /* 80 */
159 TPM_UNDEFINED,
160 TPM_MEDIUM,
161 TPM_LONG,
162 TPM_SHORT,
163 TPM_UNDEFINED, /* 85 */
164 TPM_UNDEFINED,
165 TPM_UNDEFINED,
166 TPM_UNDEFINED,
167 TPM_UNDEFINED,
168 TPM_SHORT, /* 90 */
169 TPM_SHORT,
170 TPM_SHORT,
171 TPM_SHORT,
172 TPM_SHORT,
173 TPM_UNDEFINED, /* 95 */
174 TPM_UNDEFINED,
175 TPM_UNDEFINED,
176 TPM_UNDEFINED,
177 TPM_UNDEFINED,
178 TPM_MEDIUM, /* 100 */
179 TPM_SHORT,
180 TPM_SHORT,
181 TPM_UNDEFINED,
182 TPM_UNDEFINED,
183 TPM_UNDEFINED, /* 105 */
184 TPM_UNDEFINED,
185 TPM_UNDEFINED,
186 TPM_UNDEFINED,
187 TPM_UNDEFINED,
188 TPM_SHORT, /* 110 */
189 TPM_SHORT,
190 TPM_SHORT,
191 TPM_SHORT,
192 TPM_SHORT,
193 TPM_SHORT, /* 115 */
194 TPM_SHORT,
195 TPM_SHORT,
196 TPM_UNDEFINED,
197 TPM_UNDEFINED,
198 TPM_LONG, /* 120 */
199 TPM_LONG,
200 TPM_MEDIUM,
201 TPM_UNDEFINED,
202 TPM_SHORT,
203 TPM_SHORT, /* 125 */
204 TPM_SHORT,
205 TPM_LONG,
206 TPM_SHORT,
207 TPM_SHORT,
208 TPM_SHORT, /* 130 */
209 TPM_MEDIUM,
210 TPM_UNDEFINED,
211 TPM_SHORT,
212 TPM_MEDIUM,
213 TPM_UNDEFINED, /* 135 */
214 TPM_UNDEFINED,
215 TPM_UNDEFINED,
216 TPM_UNDEFINED,
217 TPM_UNDEFINED,
218 TPM_SHORT, /* 140 */
219 TPM_SHORT,
220 TPM_UNDEFINED,
221 TPM_UNDEFINED,
222 TPM_UNDEFINED,
223 TPM_UNDEFINED, /* 145 */
224 TPM_UNDEFINED,
225 TPM_UNDEFINED,
226 TPM_UNDEFINED,
227 TPM_UNDEFINED,
228 TPM_SHORT, /* 150 */
229 TPM_MEDIUM,
230 TPM_MEDIUM,
231 TPM_SHORT,
232 TPM_SHORT,
233 TPM_UNDEFINED, /* 155 */
234 TPM_UNDEFINED,
235 TPM_UNDEFINED,
236 TPM_UNDEFINED,
237 TPM_UNDEFINED,
238 TPM_SHORT, /* 160 */
239 TPM_SHORT,
240 TPM_SHORT,
241 TPM_SHORT,
242 TPM_UNDEFINED,
243 TPM_UNDEFINED, /* 165 */
244 TPM_UNDEFINED,
245 TPM_UNDEFINED,
246 TPM_UNDEFINED,
247 TPM_UNDEFINED,
248 TPM_LONG, /* 170 */
249 TPM_UNDEFINED,
250 TPM_UNDEFINED,
251 TPM_UNDEFINED,
252 TPM_UNDEFINED,
253 TPM_UNDEFINED, /* 175 */
254 TPM_UNDEFINED,
255 TPM_UNDEFINED,
256 TPM_UNDEFINED,
257 TPM_UNDEFINED,
258 TPM_MEDIUM, /* 180 */
259 TPM_SHORT,
260 TPM_MEDIUM,
261 TPM_MEDIUM,
262 TPM_MEDIUM,
263 TPM_MEDIUM, /* 185 */
264 TPM_SHORT,
265 TPM_UNDEFINED,
266 TPM_UNDEFINED,
267 TPM_UNDEFINED,
268 TPM_UNDEFINED, /* 190 */
269 TPM_UNDEFINED,
270 TPM_UNDEFINED,
271 TPM_UNDEFINED,
272 TPM_UNDEFINED,
273 TPM_UNDEFINED, /* 195 */
274 TPM_UNDEFINED,
275 TPM_UNDEFINED,
276 TPM_UNDEFINED,
277 TPM_UNDEFINED,
278 TPM_SHORT, /* 200 */
279 TPM_UNDEFINED,
280 TPM_UNDEFINED,
281 TPM_UNDEFINED,
282 TPM_SHORT,
283 TPM_SHORT, /* 205 */
284 TPM_SHORT,
285 TPM_SHORT,
286 TPM_SHORT,
287 TPM_SHORT,
288 TPM_MEDIUM, /* 210 */
289 TPM_UNDEFINED,
290 TPM_MEDIUM,
291 TPM_MEDIUM,
292 TPM_MEDIUM,
293 TPM_UNDEFINED, /* 215 */
294 TPM_MEDIUM,
295 TPM_UNDEFINED,
296 TPM_UNDEFINED,
297 TPM_SHORT,
298 TPM_SHORT, /* 220 */
299 TPM_SHORT,
300 TPM_SHORT,
301 TPM_SHORT,
302 TPM_SHORT,
303 TPM_UNDEFINED, /* 225 */
304 TPM_UNDEFINED,
305 TPM_UNDEFINED,
306 TPM_UNDEFINED,
307 TPM_UNDEFINED,
308 TPM_SHORT, /* 230 */
309 TPM_LONG,
310 TPM_MEDIUM,
311 TPM_UNDEFINED,
312 TPM_UNDEFINED,
313 TPM_UNDEFINED, /* 235 */
314 TPM_UNDEFINED,
315 TPM_UNDEFINED,
316 TPM_UNDEFINED,
317 TPM_UNDEFINED,
318 TPM_SHORT, /* 240 */
319 TPM_UNDEFINED,
320 TPM_MEDIUM,
321};
322
1da177e4
LT
323static void user_reader_timeout(unsigned long ptr)
324{
325 struct tpm_chip *chip = (struct tpm_chip *) ptr;
326
09e12f9f
KJH
327 schedule_work(&chip->work);
328}
329
c4028958 330static void timeout_work(struct work_struct *work)
09e12f9f 331{
c4028958 332 struct tpm_chip *chip = container_of(work, struct tpm_chip, work);
09e12f9f 333
d081d470 334 mutex_lock(&chip->buffer_mutex);
1da177e4
LT
335 atomic_set(&chip->data_pending, 0);
336 memset(chip->data_buffer, 0, TPM_BUFSIZE);
d081d470 337 mutex_unlock(&chip->buffer_mutex);
1da177e4
LT
338}
339
9e18ee19
KJH
340/*
341 * Returns max number of jiffies to wait
342 */
343unsigned long tpm_calc_ordinal_duration(struct tpm_chip *chip,
344 u32 ordinal)
345{
346 int duration_idx = TPM_UNDEFINED;
347 int duration = 0;
348
349 if (ordinal < TPM_MAX_ORDINAL)
350 duration_idx = tpm_ordinal_duration[ordinal];
351 else if ((ordinal & TPM_PROTECTED_ORDINAL_MASK) <
352 TPM_MAX_PROTECTED_ORDINAL)
353 duration_idx =
354 tpm_protected_ordinal_duration[ordinal &
355 TPM_PROTECTED_ORDINAL_MASK];
356
357 if (duration_idx != TPM_UNDEFINED)
36b20020 358 duration = chip->vendor.duration[duration_idx];
9e18ee19
KJH
359 if (duration <= 0)
360 return 2 * 60 * HZ;
361 else
362 return duration;
363}
364EXPORT_SYMBOL_GPL(tpm_calc_ordinal_duration);
365
1da177e4
LT
366/*
367 * Internal kernel interface to transmit TPM commands
368 */
369static ssize_t tpm_transmit(struct tpm_chip *chip, const char *buf,
370 size_t bufsiz)
371{
d9e5b6bf 372 ssize_t rc;
9e18ee19 373 u32 count, ordinal;
700d8bdc 374 unsigned long stop;
1da177e4 375
81179bb6 376 count = be32_to_cpu(*((__be32 *) (buf + 2)));
9e18ee19 377 ordinal = be32_to_cpu(*((__be32 *) (buf + 6)));
1da177e4
LT
378 if (count == 0)
379 return -ENODATA;
380 if (count > bufsiz) {
e659a3fe 381 dev_err(chip->dev,
b76be681 382 "invalid count value %x %zx \n", count, bufsiz);
1da177e4
LT
383 return -E2BIG;
384 }
385
d081d470 386 mutex_lock(&chip->tpm_mutex);
1da177e4 387
90dda520 388 if ((rc = chip->vendor.send(chip, (u8 *) buf, count)) < 0) {
e659a3fe 389 dev_err(chip->dev,
d9e5b6bf
KH
390 "tpm_transmit: tpm_send: error %zd\n", rc);
391 goto out;
1da177e4
LT
392 }
393
27084efe
LD
394 if (chip->vendor.irq)
395 goto out_recv;
396
9e18ee19 397 stop = jiffies + tpm_calc_ordinal_duration(chip, ordinal);
1da177e4 398 do {
90dda520
KJH
399 u8 status = chip->vendor.status(chip);
400 if ((status & chip->vendor.req_complete_mask) ==
401 chip->vendor.req_complete_val)
1da177e4 402 goto out_recv;
d9e5b6bf 403
90dda520 404 if ((status == chip->vendor.req_canceled)) {
e659a3fe 405 dev_err(chip->dev, "Operation Canceled\n");
d9e5b6bf
KH
406 rc = -ECANCELED;
407 goto out;
408 }
409
410 msleep(TPM_TIMEOUT); /* CHECK */
1da177e4 411 rmb();
700d8bdc 412 } while (time_before(jiffies, stop));
1da177e4 413
90dda520 414 chip->vendor.cancel(chip);
e659a3fe 415 dev_err(chip->dev, "Operation Timed out\n");
d9e5b6bf
KH
416 rc = -ETIME;
417 goto out;
1da177e4
LT
418
419out_recv:
90dda520 420 rc = chip->vendor.recv(chip, (u8 *) buf, bufsiz);
d9e5b6bf 421 if (rc < 0)
e659a3fe 422 dev_err(chip->dev,
d9e5b6bf
KH
423 "tpm_transmit: tpm_recv: error %zd\n", rc);
424out:
d081d470 425 mutex_unlock(&chip->tpm_mutex);
d9e5b6bf 426 return rc;
1da177e4
LT
427}
428
429#define TPM_DIGEST_SIZE 20
beed53a1
KJH
430#define TPM_ERROR_SIZE 10
431#define TPM_RET_CODE_IDX 6
beed53a1
KJH
432
433enum tpm_capabilities {
08837438
RA
434 TPM_CAP_FLAG = cpu_to_be32(4),
435 TPM_CAP_PROP = cpu_to_be32(5),
436 CAP_VERSION_1_1 = cpu_to_be32(0x06),
437 CAP_VERSION_1_2 = cpu_to_be32(0x1A)
beed53a1
KJH
438};
439
440enum tpm_sub_capabilities {
08837438
RA
441 TPM_CAP_PROP_PCR = cpu_to_be32(0x101),
442 TPM_CAP_PROP_MANUFACTURER = cpu_to_be32(0x103),
443 TPM_CAP_FLAG_PERM = cpu_to_be32(0x108),
444 TPM_CAP_FLAG_VOL = cpu_to_be32(0x109),
445 TPM_CAP_PROP_OWNER = cpu_to_be32(0x111),
446 TPM_CAP_PROP_TIS_TIMEOUT = cpu_to_be32(0x115),
447 TPM_CAP_PROP_TIS_DURATION = cpu_to_be32(0x120),
beed53a1 448
1da177e4
LT
449};
450
08837438
RA
451static ssize_t transmit_cmd(struct tpm_chip *chip, struct tpm_cmd_t *cmd,
452 int len, const char *desc)
beed53a1
KJH
453{
454 int err;
455
08837438 456 len = tpm_transmit(chip,(u8 *) cmd, len);
beed53a1
KJH
457 if (len < 0)
458 return len;
459 if (len == TPM_ERROR_SIZE) {
08837438 460 err = be32_to_cpu(cmd->header.out.return_code);
beed53a1
KJH
461 dev_dbg(chip->dev, "A TPM error (%d) occurred %s\n", err, desc);
462 return err;
463 }
464 return 0;
465}
466
08837438
RA
467#define TPM_INTERNAL_RESULT_SIZE 200
468#define TPM_TAG_RQU_COMMAND cpu_to_be16(193)
469#define TPM_ORD_GET_CAP cpu_to_be32(101)
470
471static const struct tpm_input_header tpm_getcap_header = {
472 .tag = TPM_TAG_RQU_COMMAND,
473 .length = cpu_to_be32(22),
474 .ordinal = TPM_ORD_GET_CAP
475};
476
477ssize_t tpm_getcap(struct device *dev, __be32 subcap_id, cap_t *cap,
478 const char *desc)
479{
480 struct tpm_cmd_t tpm_cmd;
481 int rc;
482 struct tpm_chip *chip = dev_get_drvdata(dev);
483
484 tpm_cmd.header.in = tpm_getcap_header;
485 if (subcap_id == CAP_VERSION_1_1 || subcap_id == CAP_VERSION_1_2) {
486 tpm_cmd.params.getcap_in.cap = subcap_id;
487 /*subcap field not necessary */
488 tpm_cmd.params.getcap_in.subcap_size = cpu_to_be32(0);
489 tpm_cmd.header.in.length -= cpu_to_be32(sizeof(__be32));
490 } else {
491 if (subcap_id == TPM_CAP_FLAG_PERM ||
492 subcap_id == TPM_CAP_FLAG_VOL)
493 tpm_cmd.params.getcap_in.cap = TPM_CAP_FLAG;
494 else
495 tpm_cmd.params.getcap_in.cap = TPM_CAP_PROP;
496 tpm_cmd.params.getcap_in.subcap_size = cpu_to_be32(4);
497 tpm_cmd.params.getcap_in.subcap = subcap_id;
498 }
499 rc = transmit_cmd(chip, &tpm_cmd, TPM_INTERNAL_RESULT_SIZE, desc);
500 if (!rc)
501 *cap = tpm_cmd.params.getcap_out.cap;
502 return rc;
503}
504
08e96e48
KJH
505void tpm_gen_interrupt(struct tpm_chip *chip)
506{
08837438 507 struct tpm_cmd_t tpm_cmd;
08e96e48
KJH
508 ssize_t rc;
509
08837438
RA
510 tpm_cmd.header.in = tpm_getcap_header;
511 tpm_cmd.params.getcap_in.cap = TPM_CAP_PROP;
512 tpm_cmd.params.getcap_in.subcap_size = cpu_to_be32(4);
513 tpm_cmd.params.getcap_in.subcap = TPM_CAP_PROP_TIS_TIMEOUT;
08e96e48 514
08837438 515 rc = transmit_cmd(chip, &tpm_cmd, TPM_INTERNAL_RESULT_SIZE,
08e96e48
KJH
516 "attempting to determine the timeouts");
517}
518EXPORT_SYMBOL_GPL(tpm_gen_interrupt);
519
520void tpm_get_timeouts(struct tpm_chip *chip)
521{
08837438
RA
522 struct tpm_cmd_t tpm_cmd;
523 struct timeout_t *timeout_cap;
524 struct duration_t *duration_cap;
08e96e48
KJH
525 ssize_t rc;
526 u32 timeout;
527
08837438
RA
528 tpm_cmd.header.in = tpm_getcap_header;
529 tpm_cmd.params.getcap_in.cap = TPM_CAP_PROP;
530 tpm_cmd.params.getcap_in.subcap_size = cpu_to_be32(4);
531 tpm_cmd.params.getcap_in.subcap = TPM_CAP_PROP_TIS_TIMEOUT;
08e96e48 532
08837438 533 rc = transmit_cmd(chip, &tpm_cmd, TPM_INTERNAL_RESULT_SIZE,
08e96e48
KJH
534 "attempting to determine the timeouts");
535 if (rc)
536 goto duration;
537
08837438 538 if (be32_to_cpu(tpm_cmd.header.out.length)
08e96e48
KJH
539 != 4 * sizeof(u32))
540 goto duration;
541
08837438 542 timeout_cap = &tpm_cmd.params.getcap_out.cap.timeout;
08e96e48 543 /* Don't overwrite default if value is 0 */
08837438 544 timeout = be32_to_cpu(timeout_cap->a);
08e96e48 545 if (timeout)
9e5b1b12 546 chip->vendor.timeout_a = usecs_to_jiffies(timeout);
08837438 547 timeout = be32_to_cpu(timeout_cap->b);
08e96e48 548 if (timeout)
9e5b1b12 549 chip->vendor.timeout_b = usecs_to_jiffies(timeout);
08837438 550 timeout = be32_to_cpu(timeout_cap->c);
08e96e48 551 if (timeout)
9e5b1b12 552 chip->vendor.timeout_c = usecs_to_jiffies(timeout);
08837438 553 timeout = be32_to_cpu(timeout_cap->d);
08e96e48 554 if (timeout)
9e5b1b12 555 chip->vendor.timeout_d = usecs_to_jiffies(timeout);
08e96e48
KJH
556
557duration:
08837438
RA
558 tpm_cmd.header.in = tpm_getcap_header;
559 tpm_cmd.params.getcap_in.cap = TPM_CAP_PROP;
560 tpm_cmd.params.getcap_in.subcap_size = cpu_to_be32(4);
561 tpm_cmd.params.getcap_in.subcap = TPM_CAP_PROP_TIS_DURATION;
08e96e48 562
08837438 563 rc = transmit_cmd(chip, &tpm_cmd, TPM_INTERNAL_RESULT_SIZE,
08e96e48
KJH
564 "attempting to determine the durations");
565 if (rc)
566 return;
567
08837438 568 if (be32_to_cpu(tpm_cmd.header.out.return_code)
08e96e48
KJH
569 != 3 * sizeof(u32))
570 return;
08837438 571 duration_cap = &tpm_cmd.params.getcap_out.cap.duration;
08e96e48 572 chip->vendor.duration[TPM_SHORT] =
08837438 573 usecs_to_jiffies(be32_to_cpu(duration_cap->tpm_short));
292cf4a8
VK
574 /* The Broadcom BCM0102 chipset in a Dell Latitude D820 gets the above
575 * value wrong and apparently reports msecs rather than usecs. So we
576 * fix up the resulting too-small TPM_SHORT value to make things work.
577 */
578 if (chip->vendor.duration[TPM_SHORT] < (HZ/100))
579 chip->vendor.duration[TPM_SHORT] = HZ;
580
08e96e48 581 chip->vendor.duration[TPM_MEDIUM] =
08837438 582 usecs_to_jiffies(be32_to_cpu(duration_cap->tpm_medium));
08e96e48 583 chip->vendor.duration[TPM_LONG] =
08837438 584 usecs_to_jiffies(be32_to_cpu(duration_cap->tpm_long));
08e96e48
KJH
585}
586EXPORT_SYMBOL_GPL(tpm_get_timeouts);
587
588void tpm_continue_selftest(struct tpm_chip *chip)
589{
590 u8 data[] = {
591 0, 193, /* TPM_TAG_RQU_COMMAND */
592 0, 0, 0, 10, /* length */
593 0, 0, 0, 83, /* TPM_ORD_GetCapability */
594 };
595
596 tpm_transmit(chip, data, sizeof(data));
597}
598EXPORT_SYMBOL_GPL(tpm_continue_selftest);
599
600ssize_t tpm_show_enabled(struct device * dev, struct device_attribute * attr,
601 char *buf)
602{
08837438 603 cap_t cap;
08e96e48
KJH
604 ssize_t rc;
605
08837438
RA
606 rc = tpm_getcap(dev, TPM_CAP_FLAG_PERM, &cap,
607 "attempting to determine the permanent enabled state");
608 if (rc)
08e96e48 609 return 0;
ec288bd3 610
08837438 611 rc = sprintf(buf, "%d\n", !cap.perm_flags.disable);
ec288bd3 612 return rc;
08e96e48
KJH
613}
614EXPORT_SYMBOL_GPL(tpm_show_enabled);
615
616ssize_t tpm_show_active(struct device * dev, struct device_attribute * attr,
617 char *buf)
618{
08837438 619 cap_t cap;
08e96e48
KJH
620 ssize_t rc;
621
08837438
RA
622 rc = tpm_getcap(dev, TPM_CAP_FLAG_PERM, &cap,
623 "attempting to determine the permanent active state");
624 if (rc)
08e96e48 625 return 0;
ec288bd3 626
08837438 627 rc = sprintf(buf, "%d\n", !cap.perm_flags.deactivated);
ec288bd3 628 return rc;
08e96e48
KJH
629}
630EXPORT_SYMBOL_GPL(tpm_show_active);
631
632ssize_t tpm_show_owned(struct device * dev, struct device_attribute * attr,
633 char *buf)
634{
08837438 635 cap_t cap;
08e96e48
KJH
636 ssize_t rc;
637
08837438
RA
638 rc = tpm_getcap(dev, TPM_CAP_PROP_OWNER, &cap,
639 "attempting to determine the owner state");
640 if (rc)
08e96e48 641 return 0;
ec288bd3 642
08837438 643 rc = sprintf(buf, "%d\n", cap.owned);
ec288bd3 644 return rc;
08e96e48
KJH
645}
646EXPORT_SYMBOL_GPL(tpm_show_owned);
647
648ssize_t tpm_show_temp_deactivated(struct device * dev,
649 struct device_attribute * attr, char *buf)
650{
08837438 651 cap_t cap;
08e96e48
KJH
652 ssize_t rc;
653
08837438
RA
654 rc = tpm_getcap(dev, TPM_CAP_FLAG_VOL, &cap,
655 "attempting to determine the temporary state");
656 if (rc)
08e96e48 657 return 0;
ec288bd3 658
08837438 659 rc = sprintf(buf, "%d\n", cap.stclear_flags.deactivated);
ec288bd3 660 return rc;
08e96e48
KJH
661}
662EXPORT_SYMBOL_GPL(tpm_show_temp_deactivated);
663
dff37e4b 664static const u8 pcrread[] = {
1da177e4
LT
665 0, 193, /* TPM_TAG_RQU_COMMAND */
666 0, 0, 0, 14, /* length */
667 0, 0, 0, 21, /* TPM_ORD_PcrRead */
668 0, 0, 0, 0 /* PCR index */
669};
670
6659ca2a
KH
671ssize_t tpm_show_pcrs(struct device *dev, struct device_attribute *attr,
672 char *buf)
1da177e4 673{
08837438 674 cap_t cap;
ec288bd3 675 u8 *data;
beed53a1 676 ssize_t rc;
81179bb6
KH
677 int i, j, num_pcrs;
678 __be32 index;
1da177e4 679 char *str = buf;
e659a3fe 680 struct tpm_chip *chip = dev_get_drvdata(dev);
1da177e4 681
ec288bd3
MO
682 data = kzalloc(TPM_INTERNAL_RESULT_SIZE, GFP_KERNEL);
683 if (!data)
684 return -ENOMEM;
685
08837438 686 rc = tpm_getcap(dev, TPM_CAP_PROP_PCR, &cap,
beed53a1 687 "attempting to determine the number of PCRS");
08837438 688 if (rc)
e234bc97 689 return 0;
1da177e4 690
08837438 691 num_pcrs = be32_to_cpu(cap.num_pcrs);
1da177e4
LT
692 for (i = 0; i < num_pcrs; i++) {
693 memcpy(data, pcrread, sizeof(pcrread));
694 index = cpu_to_be32(i);
695 memcpy(data + 10, &index, 4);
08837438
RA
696 rc = transmit_cmd(chip, (struct tpm_cmd_t *)data,
697 TPM_INTERNAL_RESULT_SIZE,
698 "attempting to read a PCR");
beed53a1 699 if (rc)
08837438 700 break;
1da177e4
LT
701 str += sprintf(str, "PCR-%02d: ", i);
702 for (j = 0; j < TPM_DIGEST_SIZE; j++)
703 str += sprintf(str, "%02X ", *(data + 10 + j));
704 str += sprintf(str, "\n");
705 }
ec288bd3 706 kfree(data);
1da177e4
LT
707 return str - buf;
708}
6659ca2a 709EXPORT_SYMBOL_GPL(tpm_show_pcrs);
1da177e4
LT
710
711#define READ_PUBEK_RESULT_SIZE 314
08837438
RA
712#define TPM_ORD_READPUBEK cpu_to_be32(124)
713struct tpm_input_header tpm_readpubek_header = {
714 .tag = TPM_TAG_RQU_COMMAND,
715 .length = cpu_to_be32(30),
716 .ordinal = TPM_ORD_READPUBEK
1da177e4
LT
717};
718
6659ca2a
KH
719ssize_t tpm_show_pubek(struct device *dev, struct device_attribute *attr,
720 char *buf)
1da177e4 721{
2df7111f 722 u8 *data;
08837438 723 struct tpm_cmd_t tpm_cmd;
beed53a1 724 ssize_t err;
81179bb6 725 int i, rc;
1da177e4
LT
726 char *str = buf;
727
e659a3fe 728 struct tpm_chip *chip = dev_get_drvdata(dev);
1da177e4 729
08837438
RA
730 tpm_cmd.header.in = tpm_readpubek_header;
731 err = transmit_cmd(chip, &tpm_cmd, READ_PUBEK_RESULT_SIZE,
beed53a1
KJH
732 "attempting to read the PUBEK");
733 if (err)
34d6e075 734 goto out;
1da177e4
LT
735
736 /*
737 ignore header 10 bytes
738 algorithm 32 bits (1 == RSA )
739 encscheme 16 bits
740 sigscheme 16 bits
741 parameters (RSA 12->bytes: keybit, #primes, expbit)
742 keylenbytes 32 bits
743 256 byte modulus
744 ignore checksum 20 bytes
745 */
08837438 746 data = tpm_cmd.params.readpubek_out_buffer;
1da177e4
LT
747 str +=
748 sprintf(str,
749 "Algorithm: %02X %02X %02X %02X\nEncscheme: %02X %02X\n"
750 "Sigscheme: %02X %02X\nParameters: %02X %02X %02X %02X"
751 " %02X %02X %02X %02X %02X %02X %02X %02X\n"
752 "Modulus length: %d\nModulus: \n",
753 data[10], data[11], data[12], data[13], data[14],
754 data[15], data[16], data[17], data[22], data[23],
755 data[24], data[25], data[26], data[27], data[28],
756 data[29], data[30], data[31], data[32], data[33],
1dda8abe 757 be32_to_cpu(*((__be32 *) (data + 34))));
1da177e4
LT
758
759 for (i = 0; i < 256; i++) {
1dda8abe 760 str += sprintf(str, "%02X ", data[i + 38]);
1da177e4
LT
761 if ((i + 1) % 16 == 0)
762 str += sprintf(str, "\n");
763 }
34d6e075 764out:
beed53a1 765 rc = str - buf;
2df7111f 766 return rc;
1da177e4 767}
6659ca2a 768EXPORT_SYMBOL_GPL(tpm_show_pubek);
1da177e4 769
1da177e4 770
6659ca2a
KH
771ssize_t tpm_show_caps(struct device *dev, struct device_attribute *attr,
772 char *buf)
1da177e4 773{
08837438 774 cap_t cap;
beed53a1 775 ssize_t rc;
1da177e4
LT
776 char *str = buf;
777
08837438 778 rc = tpm_getcap(dev, TPM_CAP_PROP_MANUFACTURER, &cap,
beed53a1 779 "attempting to determine the manufacturer");
08837438 780 if (rc)
beed53a1 781 return 0;
1da177e4 782 str += sprintf(str, "Manufacturer: 0x%x\n",
08837438 783 be32_to_cpu(cap.manufacturer_id));
1da177e4 784
08837438
RA
785 rc = tpm_getcap(dev, CAP_VERSION_1_1, &cap,
786 "attempting to determine the 1.1 version");
beed53a1 787 if (rc)
08837438 788 return 0;
beed53a1
KJH
789 str += sprintf(str,
790 "TCG version: %d.%d\nFirmware version: %d.%d\n",
08837438
RA
791 cap.tpm_version.Major, cap.tpm_version.Minor,
792 cap.tpm_version.revMajor, cap.tpm_version.revMinor);
1da177e4
LT
793 return str - buf;
794}
6659ca2a
KH
795EXPORT_SYMBOL_GPL(tpm_show_caps);
796
08e96e48
KJH
797ssize_t tpm_show_caps_1_2(struct device * dev,
798 struct device_attribute * attr, char *buf)
799{
08837438
RA
800 cap_t cap;
801 ssize_t rc;
08e96e48
KJH
802 char *str = buf;
803
08837438
RA
804 rc = tpm_getcap(dev, TPM_CAP_PROP_MANUFACTURER, &cap,
805 "attempting to determine the manufacturer");
806 if (rc)
08e96e48 807 return 0;
08e96e48 808 str += sprintf(str, "Manufacturer: 0x%x\n",
08837438
RA
809 be32_to_cpu(cap.manufacturer_id));
810 rc = tpm_getcap(dev, CAP_VERSION_1_2, &cap,
811 "attempting to determine the 1.2 version");
812 if (rc)
813 return 0;
08e96e48
KJH
814 str += sprintf(str,
815 "TCG version: %d.%d\nFirmware version: %d.%d\n",
08837438
RA
816 cap.tpm_version_1_2.Major, cap.tpm_version_1_2.Minor,
817 cap.tpm_version_1_2.revMajor,
818 cap.tpm_version_1_2.revMinor);
08e96e48
KJH
819 return str - buf;
820}
821EXPORT_SYMBOL_GPL(tpm_show_caps_1_2);
822
6659ca2a
KH
823ssize_t tpm_store_cancel(struct device *dev, struct device_attribute *attr,
824 const char *buf, size_t count)
825{
826 struct tpm_chip *chip = dev_get_drvdata(dev);
827 if (chip == NULL)
828 return 0;
829
90dda520 830 chip->vendor.cancel(chip);
6659ca2a
KH
831 return count;
832}
833EXPORT_SYMBOL_GPL(tpm_store_cancel);
1da177e4 834
1da177e4
LT
835/*
836 * Device file system interface to the TPM
f89c5edb
RA
837 *
838 * It's assured that the chip will be opened just once,
839 * by the check of is_open variable, which is protected
840 * by driver_lock.
1da177e4
LT
841 */
842int tpm_open(struct inode *inode, struct file *file)
843{
f02a9364 844 int minor = iminor(inode);
1da177e4
LT
845 struct tpm_chip *chip = NULL, *pos;
846
f02a9364
RA
847 rcu_read_lock();
848 list_for_each_entry_rcu(pos, &tpm_chip_list, list) {
90dda520 849 if (pos->vendor.miscdev.minor == minor) {
1da177e4 850 chip = pos;
f02a9364 851 get_device(chip->dev);
1da177e4
LT
852 break;
853 }
854 }
f02a9364 855 rcu_read_unlock();
1da177e4 856
f02a9364
RA
857 if (!chip)
858 return -ENODEV;
1da177e4 859
dc36d32c 860 if (test_and_set_bit(0, &chip->is_open)) {
b888c87b 861 dev_dbg(chip->dev, "Another process owns this TPM\n");
f02a9364
RA
862 put_device(chip->dev);
863 return -EBUSY;
1da177e4
LT
864 }
865
1da177e4
LT
866 chip->data_buffer = kmalloc(TPM_BUFSIZE * sizeof(u8), GFP_KERNEL);
867 if (chip->data_buffer == NULL) {
dc36d32c 868 clear_bit(0, &chip->is_open);
e659a3fe 869 put_device(chip->dev);
1da177e4
LT
870 return -ENOMEM;
871 }
872
873 atomic_set(&chip->data_pending, 0);
874
875 file->private_data = chip;
876 return 0;
1da177e4 877}
1da177e4
LT
878EXPORT_SYMBOL_GPL(tpm_open);
879
f02a9364
RA
880/*
881 * Called on file close
882 */
1da177e4
LT
883int tpm_release(struct inode *inode, struct file *file)
884{
885 struct tpm_chip *chip = file->private_data;
1da177e4 886
4bdec11f 887 del_singleshot_timer_sync(&chip->user_read_timer);
8e39c933 888 flush_scheduled_work();
5e976d55 889 file->private_data = NULL;
1da177e4 890 atomic_set(&chip->data_pending, 0);
f02a9364 891 kfree(chip->data_buffer);
dc36d32c 892 clear_bit(0, &chip->is_open);
e659a3fe 893 put_device(chip->dev);
1da177e4
LT
894 return 0;
895}
1da177e4
LT
896EXPORT_SYMBOL_GPL(tpm_release);
897
b888c87b 898ssize_t tpm_write(struct file *file, const char __user *buf,
3c2f606a 899 size_t size, loff_t *off)
1da177e4
LT
900{
901 struct tpm_chip *chip = file->private_data;
01476001 902 size_t in_size = size, out_size;
1da177e4
LT
903
904 /* cannot perform a write until the read has cleared
905 either via tpm_read or a user_read_timer timeout */
700d8bdc
NA
906 while (atomic_read(&chip->data_pending) != 0)
907 msleep(TPM_TIMEOUT);
1da177e4 908
d081d470 909 mutex_lock(&chip->buffer_mutex);
1da177e4
LT
910
911 if (in_size > TPM_BUFSIZE)
912 in_size = TPM_BUFSIZE;
913
914 if (copy_from_user
915 (chip->data_buffer, (void __user *) buf, in_size)) {
d081d470 916 mutex_unlock(&chip->buffer_mutex);
1da177e4
LT
917 return -EFAULT;
918 }
919
920 /* atomic tpm command send and result receive */
921 out_size = tpm_transmit(chip, chip->data_buffer, TPM_BUFSIZE);
922
923 atomic_set(&chip->data_pending, out_size);
d081d470 924 mutex_unlock(&chip->buffer_mutex);
1da177e4
LT
925
926 /* Set a timeout by which the reader must come claim the result */
fe3fd483 927 mod_timer(&chip->user_read_timer, jiffies + (60 * HZ));
1da177e4
LT
928
929 return in_size;
930}
1da177e4
LT
931EXPORT_SYMBOL_GPL(tpm_write);
932
3c2f606a
KJH
933ssize_t tpm_read(struct file *file, char __user *buf,
934 size_t size, loff_t *off)
1da177e4
LT
935{
936 struct tpm_chip *chip = file->private_data;
01476001 937 ssize_t ret_size;
1da177e4 938
5b44bd58 939 del_singleshot_timer_sync(&chip->user_read_timer);
ba396115 940 flush_scheduled_work();
5b44bd58
KH
941 ret_size = atomic_read(&chip->data_pending);
942 atomic_set(&chip->data_pending, 0);
943 if (ret_size > 0) { /* relay data */
944 if (size < ret_size)
945 ret_size = size;
1da177e4 946
d081d470 947 mutex_lock(&chip->buffer_mutex);
f6a2382c 948 if (copy_to_user(buf, chip->data_buffer, ret_size))
5b44bd58 949 ret_size = -EFAULT;
d081d470 950 mutex_unlock(&chip->buffer_mutex);
1da177e4
LT
951 }
952
953 return ret_size;
954}
1da177e4
LT
955EXPORT_SYMBOL_GPL(tpm_read);
956
e659a3fe 957void tpm_remove_hardware(struct device *dev)
1da177e4 958{
e659a3fe 959 struct tpm_chip *chip = dev_get_drvdata(dev);
1da177e4
LT
960
961 if (chip == NULL) {
e659a3fe 962 dev_err(dev, "No device data found\n");
1da177e4
LT
963 return;
964 }
965
966 spin_lock(&driver_lock);
f02a9364 967 list_del_rcu(&chip->list);
1da177e4 968 spin_unlock(&driver_lock);
f02a9364 969 synchronize_rcu();
1da177e4 970
90dda520 971 misc_deregister(&chip->vendor.miscdev);
90dda520 972 sysfs_remove_group(&dev->kobj, chip->vendor.attr_group);
55a82ab3 973 tpm_bios_log_teardown(chip->bios_dir);
1da177e4 974
5bd91f18
RM
975 /* write it this way to be explicit (chip->dev == dev) */
976 put_device(chip->dev);
1da177e4 977}
e659a3fe 978EXPORT_SYMBOL_GPL(tpm_remove_hardware);
1da177e4 979
1da177e4
LT
980/*
981 * We are about to suspend. Save the TPM state
982 * so that it can be restored.
983 */
ce2c87d4 984int tpm_pm_suspend(struct device *dev, pm_message_t pm_state)
1da177e4 985{
ce2c87d4 986 struct tpm_chip *chip = dev_get_drvdata(dev);
2490c681
DS
987 u8 savestate[] = {
988 0, 193, /* TPM_TAG_RQU_COMMAND */
989 0, 0, 0, 10, /* blob length (in bytes) */
990 0, 0, 0, 152 /* TPM_ORD_SaveState */
991 };
992
1da177e4
LT
993 if (chip == NULL)
994 return -ENODEV;
995
996 tpm_transmit(chip, savestate, sizeof(savestate));
997 return 0;
998}
1da177e4
LT
999EXPORT_SYMBOL_GPL(tpm_pm_suspend);
1000
1001/*
1002 * Resume from a power safe. The BIOS already restored
1003 * the TPM state.
1004 */
ce2c87d4 1005int tpm_pm_resume(struct device *dev)
1da177e4 1006{
ce2c87d4 1007 struct tpm_chip *chip = dev_get_drvdata(dev);
1da177e4
LT
1008
1009 if (chip == NULL)
1010 return -ENODEV;
1011
1da177e4
LT
1012 return 0;
1013}
1da177e4
LT
1014EXPORT_SYMBOL_GPL(tpm_pm_resume);
1015
253115b7
RA
1016/* In case vendor provided release function, call it too.*/
1017
1018void tpm_dev_vendor_release(struct tpm_chip *chip)
1019{
1020 if (chip->vendor.release)
1021 chip->vendor.release(chip->dev);
1022
1023 clear_bit(chip->dev_num, dev_mask);
1024 kfree(chip->vendor.miscdev.name);
1025}
1026EXPORT_SYMBOL_GPL(tpm_dev_vendor_release);
1027
1028
5bd91f18
RM
1029/*
1030 * Once all references to platform device are down to 0,
1031 * release all allocated structures.
5bd91f18 1032 */
cbb2ed4a 1033void tpm_dev_release(struct device *dev)
5bd91f18
RM
1034{
1035 struct tpm_chip *chip = dev_get_drvdata(dev);
1036
253115b7 1037 tpm_dev_vendor_release(chip);
5bd91f18 1038
253115b7 1039 chip->release(dev);
5bd91f18
RM
1040 kfree(chip);
1041}
253115b7 1042EXPORT_SYMBOL_GPL(tpm_dev_release);
5bd91f18 1043
1da177e4
LT
1044/*
1045 * Called from tpm_<specific>.c probe function only for devices
1046 * the driver has determined it should claim. Prior to calling
1047 * this function the specific probe function has called pci_enable_device
1048 * upon errant exit from this function specific probe function should call
1049 * pci_disable_device
1050 */
f02a9364
RA
1051struct tpm_chip *tpm_register_hardware(struct device *dev,
1052 const struct tpm_vendor_specific *entry)
1da177e4 1053{
6f9beccb
KJH
1054#define DEVNAME_SIZE 7
1055
1056 char *devname;
1da177e4 1057 struct tpm_chip *chip;
1da177e4
LT
1058
1059 /* Driver specific per-device data */
b888c87b 1060 chip = kzalloc(sizeof(*chip), GFP_KERNEL);
8e39c933
PW
1061 devname = kmalloc(DEVNAME_SIZE, GFP_KERNEL);
1062
dd78c943
AM
1063 if (chip == NULL || devname == NULL)
1064 goto out_free;
1da177e4 1065
d081d470
MK
1066 mutex_init(&chip->buffer_mutex);
1067 mutex_init(&chip->tpm_mutex);
1da177e4
LT
1068 INIT_LIST_HEAD(&chip->list);
1069
c4028958 1070 INIT_WORK(&chip->work, timeout_work);
09e12f9f 1071
40565f19
JS
1072 setup_timer(&chip->user_read_timer, user_reader_timeout,
1073 (unsigned long)chip);
fe3fd483 1074
90dda520 1075 memcpy(&chip->vendor, entry, sizeof(struct tpm_vendor_specific));
1da177e4 1076
10685a95 1077 chip->dev_num = find_first_zero_bit(dev_mask, TPM_NUM_DEVICES);
1da177e4 1078
10685a95 1079 if (chip->dev_num >= TPM_NUM_DEVICES) {
b888c87b 1080 dev_err(dev, "No available tpm device numbers\n");
dd78c943 1081 goto out_free;
1da177e4 1082 } else if (chip->dev_num == 0)
90dda520 1083 chip->vendor.miscdev.minor = TPM_MINOR;
1da177e4 1084 else
90dda520 1085 chip->vendor.miscdev.minor = MISC_DYNAMIC_MINOR;
1da177e4 1086
10685a95
KJH
1087 set_bit(chip->dev_num, dev_mask);
1088
6f9beccb 1089 scnprintf(devname, DEVNAME_SIZE, "%s%d", "tpm", chip->dev_num);
90dda520 1090 chip->vendor.miscdev.name = devname;
1da177e4 1091
94fbcded 1092 chip->vendor.miscdev.parent = dev;
e659a3fe 1093 chip->dev = get_device(dev);
5bd91f18
RM
1094 chip->release = dev->release;
1095 dev->release = tpm_dev_release;
1096 dev_set_drvdata(dev, chip);
1da177e4 1097
90dda520 1098 if (misc_register(&chip->vendor.miscdev)) {
e659a3fe 1099 dev_err(chip->dev,
1da177e4 1100 "unable to misc_register %s, minor %d\n",
90dda520
KJH
1101 chip->vendor.miscdev.name,
1102 chip->vendor.miscdev.minor);
5bd91f18 1103 put_device(chip->dev);
e0dd03ca 1104 return NULL;
1da177e4
LT
1105 }
1106
f33d9bd5 1107 if (sysfs_create_group(&dev->kobj, chip->vendor.attr_group)) {
5d469ec0 1108 misc_deregister(&chip->vendor.miscdev);
5bd91f18 1109 put_device(chip->dev);
f02a9364 1110
f33d9bd5
JG
1111 return NULL;
1112 }
1da177e4 1113
55a82ab3
KJH
1114 chip->bios_dir = tpm_bios_log_setup(devname);
1115
f02a9364
RA
1116 /* Make chip available */
1117 spin_lock(&driver_lock);
1118 list_add_rcu(&chip->list, &tpm_chip_list);
1119 spin_unlock(&driver_lock);
1120
e0dd03ca 1121 return chip;
dd78c943
AM
1122
1123out_free:
1124 kfree(chip);
1125 kfree(devname);
1126 return NULL;
1da177e4 1127}
1da177e4
LT
1128EXPORT_SYMBOL_GPL(tpm_register_hardware);
1129
1da177e4
LT
1130MODULE_AUTHOR("Leendert van Doorn (leendert@watson.ibm.com)");
1131MODULE_DESCRIPTION("TPM Driver");
1132MODULE_VERSION("2.0");
1133MODULE_LICENSE("GPL");