1=head1 NAME
2
3tpm_nvwrite
4
5=head1 SYNOPSIS
6
7B<tpm_nvwrite [OPTIONS]>
8
9=head1 DESCRIPTION
10
11B<tpm_nvwrite> writes data to an NVRAM area.
12The user must provide the index of the NVRAM area as well as the data to
13write into the NVRAM area. Optionally an offset into the NVRAM
14area can be given where the writing of the data is to start. Similarly
15the use may provide the number of bytes to write into the
16NVRAM area. Some NVRAM areas only allow write sizes of zero, i.e., NVRAM
17area index 0.
18If the NVRAM area has permission bits set that require owner or NVRAM area
19authentication, then the password must be provided via the password option.
20
21The following options are supported:
22
23=over 4
24
25=item B<-h, --help>
26
27Display command usage info.
28
29=item B<-v, --version>
30
31Display command version info.
32
33=item B<-l, --log [none|error|info|debug]>
34
35Set logging level.
36
37=item B<-u, --unicode>
38
39Use TSS UNICODE encoding for passwords to comply with applications
40using TSS popup boxes
41
42=item B<-z, --well-known>
43
44Use a secret of all zeros (20 bytes of zeros) as either the NVRAM area or owner secret.
45
46=item B<-p, --password>
47
48Depending on what type of authentication is required for the NVRAM area, this must either
49be the NVRAM area or owner password.
50
51A password may be directly provided for example by using '--password=password' or
52-ppassword. If no password is provided then the program will prompt the user for the
53password.
54
55=item B<-i, --index> (optional parameter)
56
57The index of the NVRAM area.
58The parameter may either be a decimal number or a hexadecimal number starting with '0x'.
59
60=item B<-s, --size>
61
62The number of bytes to write to the NVRAM area. This parameter may be used to truncating
63the data that are for example read from a file.
64The parameter may either be a decimal number or a hexadecimal number starting with '0x'.
65
66=item B<-n, --offset> (optional parameter)
67
68The offset into the NVRAM area where to start writing.
69The parameter may either be a decimal number or a hexadecimal number starting with '0x'.
70
71=item B<-f, --filename> (optional parameter)
72
73The name of a file from which to read data and copy them into the NVRAM area.
74
75=item B<-d, --data> (optional parameter)
76
77The data to write into the NVRAM area passed in the command line.
78
79=item B<-m, --fill-value> (optional parameter)
80
81The byte to fill the NVRAM area with.
82
83=back
84
85=head1 SEE ALSO
86
87B<tpm_nvdefine>(8), B<tpm_nvinfo>(8), B<tpm_nvread>(8), B<tpm_nvrelease>(8)
88
89=head1 REPORTING BUGS
90
91Report bugs to <trousers-users@lists.sourceforge.net>
92