head	1.1;
branch	1.1.1;
access;
symbols
	netbsd-11-0-RC4:1.1.1.1
	netbsd-11-0-RC3:1.1.1.1
	netbsd-11-0-RC2:1.1.1.1
	netbsd-11-0-RC1:1.1.1.1
	perseant-exfatfs-base-20250801:1.1.1.1
	netbsd-11:1.1.1.1.0.18
	netbsd-11-base:1.1.1.1
	netbsd-10-1-RELEASE:1.1.1.1
	perseant-exfatfs-base-20240630:1.1.1.1
	perseant-exfatfs:1.1.1.1.0.16
	perseant-exfatfs-base:1.1.1.1
	netbsd-9-4-RELEASE:1.1.1.1
	netbsd-10-0-RELEASE:1.1.1.1
	netbsd-10-0-RC6:1.1.1.1
	netbsd-10-0-RC5:1.1.1.1
	netbsd-10-0-RC4:1.1.1.1
	netbsd-10-0-RC3:1.1.1.1
	netbsd-10-0-RC2:1.1.1.1
	netbsd-10-0-RC1:1.1.1.1
	netbsd-10:1.1.1.1.0.14
	netbsd-10-base:1.1.1.1
	netbsd-9-3-RELEASE:1.1.1.1
	cjep_sun2x-base1:1.1.1.1
	cjep_sun2x:1.1.1.1.0.12
	cjep_sun2x-base:1.1.1.1
	cjep_staticlib_x-base1:1.1.1.1
	netbsd-9-2-RELEASE:1.1.1.1
	cjep_staticlib_x:1.1.1.1.0.10
	cjep_staticlib_x-base:1.1.1.1
	netbsd-9-1-RELEASE:1.1.1.1
	phil-wifi-20200421:1.1.1.1
	phil-wifi-20200411:1.1.1.1
	is-mlppp:1.1.1.1.0.8
	is-mlppp-base:1.1.1.1
	phil-wifi-20200406:1.1.1.1
	netbsd-9-0-RELEASE:1.1.1.1
	netbsd-9-0-RC2:1.1.1.1
	netbsd-9-0-RC1:1.1.1.1
	phil-wifi-20191119:1.1.1.1
	netbsd-9:1.1.1.1.0.6
	netbsd-9-base:1.1.1.1
	phil-wifi:1.1.1.1.0.4
	phil-wifi-20190609:1.1.1.1
	pgoyette-compat-merge-20190127:1.1.1.1.2.2
	pgoyette-compat-20190127:1.1.1.1
	pgoyette-compat:1.1.1.1.0.2
	pgoyette-compat-20190118:1.1.1.1
	TPM_TOOLS1_3_9_1:1.1.1.1
	TROUSERS:1.1.1;
locks; strict;
comment	@# @;


1.1
date	2019.01.07.15.37.42;	author christos;	state Exp;
branches
	1.1.1.1;
next	;
commitid	4MkYRYj7o0ZZHR6B;

1.1.1.1
date	2019.01.07.15.37.42;	author christos;	state Exp;
branches
	1.1.1.1.2.1
	1.1.1.1.4.1;
next	;
commitid	4MkYRYj7o0ZZHR6B;

1.1.1.1.2.1
date	2019.01.07.15.37.42;	author pgoyette;	state dead;
branches;
next	1.1.1.1.2.2;
commitid	Lmlzg3OVT2cd6f8B;

1.1.1.1.2.2
date	2019.01.18.08.48.26;	author pgoyette;	state Exp;
branches;
next	;
commitid	Lmlzg3OVT2cd6f8B;

1.1.1.1.4.1
date	2019.01.07.15.37.42;	author christos;	state dead;
branches;
next	1.1.1.1.4.2;
commitid	jtc8rnCzWiEEHGqB;

1.1.1.1.4.2
date	2019.06.10.21.42.08;	author christos;	state Exp;
branches;
next	;
commitid	jtc8rnCzWiEEHGqB;


desc
@@


1.1
log
@Initial revision
@
text
@=head1 NAME

tpm_nvdefine

=head1 SYNOPSIS

B<tpm_nvdefine [OPTIONS]>

=head1 DESCRIPTION

B<tpm_nvdefine> defines a new NVRAM area at the given index and of given
size. The user has to provide the permissions that control access to
the NVRAM area.

Owner authentication is necessary once the NVRAM area 0xFFFFFFFF has been
defined. The owner password may be provided on the command line using
the owner password option.

The following options are supported:

=over 4

=item B<-h, --help>

Display command usage info.

=item B<-v, --version>

Display command version info.

=item B<-l, --log [none|error|info|debug]>

Set logging level.

=item B<-u, --unicode>

Use TSS UNICODE encoding for passwords to comply with applications
using TSS popup boxes

=item B<-y, --owner-well-known>

Use a secret of all zeros (20 bytes of zeros) as the owner's secret.

=item B<-z, --area-well-known>

Use a secret of all zeros (20 bytes of zeros) as the NVRAM area's secret.

=item B<-o, --pwdo> (optional parameter)

The owner password.

A password may be directly provided for example by using '--pwdo=password' or
'-opassword'. If no password is provided with this option then the program will
prompt the user for the password.

=item B<-a, --pwda> (optional parameter)

The NVRAM area password.

A password may be directly provided for example by using '--pwda=password' or
'-apassword'. If no password is provided with this option then the program will
prompt the user for the password.

=item B<-i, --index>

The index of the NVRAM area.
The parameter must either be a decimal number or a hexadecimal number starting with '0x'.

To select the NVRAM area with index 0x100, the command line parameter should be '-i 0x100' or
'--index 0x100'.

=item B<-s, --size>

The size of the NVRAM area.
The parameter must either be a decimal number or a hexadecimal number starting with '0x'.

=item B<-p, --permissions>

The access permissions associated with the NVRAM area.
The parameter must either be a decimal number or a hexadecimal number staring with '0x'. It is
possible to logically 'or' numbers or strings. The following strings are supported:

=over 4

=item B<AUTHREAD>

Reading requires NVRAM area authorization.

=item B<AUTHWRITE>

Writing requires NVRAM area authorization.

=item B<PPREAD>

Reading requires physical presence.

=item B<PPWRITE>

Writing requires physical presence.

=item B<OWNERREAD>

Reading requires owner authorization.

=item B<OWNERWRITE>

Writing requires owner authorization.

=item B<GLOBALLOCK>

A write to index 0 locks the NVRAM area until the next TPM_Startup(ST_CLEAR)

=item B<READ_STCLEAR>

A read with size 0 on the same index prevents further reading until the next TPM_Startup(ST_CLEAR)

=item B<WRITE_STCLEAR>

A write with size 0 to the same index prevents further writing until the next TPM_Startup(ST_CLEAR)

=item B<WRITEDEFINE>

A write with size 0 to the same index locks the NVRAM area permanently

=item B<WRITEALL>

The value must be written in a single operation

=back

An example of a permission parameter is:

--permissions="OWNERREAD|OWNERWRITE"

=item B<>

=back

=head1 SEE ALSO

B<tpm_nvread>(8), B<tpm_nvwrite>(8), B<tpm_nvrelease>(8), B<tpm_nvinfo>(8)

=head1 REPORTING BUGS

Report bugs to <trousers-users@@lists.sourceforge.net>
@


1.1.1.1
log
@tpm-tools (1.3.9.1)

    - Builds with openssl 1.1.0
    - Align code properly so gcc-6 does not complain
    - update symbol file.
    - drop 02-cflags-errors-unused.patch, -Werror is gone.
    - update 03-fix-bool-error-parseStringWithValues.patch, different fix
      upstream, does not look right.

tpm-tools (1.3.8.2)

  * Add patch 03 to fix FTBFS with gcc-5
  * Merge patch 04 to fix FTBFS with clang
    Thanks to Alexander <email address hidden> for the patch.
  * Bump Standards Version to 3.9.6
@
text
@@


1.1.1.1.4.1
log
@file tpm_nvdefine.pod was added on branch phil-wifi on 2019-06-10 21:42:08 +0000
@
text
@d1 145
@


1.1.1.1.4.2
log
@Sync with HEAD
@
text
@a0 145
=head1 NAME

tpm_nvdefine

=head1 SYNOPSIS

B<tpm_nvdefine [OPTIONS]>

=head1 DESCRIPTION

B<tpm_nvdefine> defines a new NVRAM area at the given index and of given
size. The user has to provide the permissions that control access to
the NVRAM area.

Owner authentication is necessary once the NVRAM area 0xFFFFFFFF has been
defined. The owner password may be provided on the command line using
the owner password option.

The following options are supported:

=over 4

=item B<-h, --help>

Display command usage info.

=item B<-v, --version>

Display command version info.

=item B<-l, --log [none|error|info|debug]>

Set logging level.

=item B<-u, --unicode>

Use TSS UNICODE encoding for passwords to comply with applications
using TSS popup boxes

=item B<-y, --owner-well-known>

Use a secret of all zeros (20 bytes of zeros) as the owner's secret.

=item B<-z, --area-well-known>

Use a secret of all zeros (20 bytes of zeros) as the NVRAM area's secret.

=item B<-o, --pwdo> (optional parameter)

The owner password.

A password may be directly provided for example by using '--pwdo=password' or
'-opassword'. If no password is provided with this option then the program will
prompt the user for the password.

=item B<-a, --pwda> (optional parameter)

The NVRAM area password.

A password may be directly provided for example by using '--pwda=password' or
'-apassword'. If no password is provided with this option then the program will
prompt the user for the password.

=item B<-i, --index>

The index of the NVRAM area.
The parameter must either be a decimal number or a hexadecimal number starting with '0x'.

To select the NVRAM area with index 0x100, the command line parameter should be '-i 0x100' or
'--index 0x100'.

=item B<-s, --size>

The size of the NVRAM area.
The parameter must either be a decimal number or a hexadecimal number starting with '0x'.

=item B<-p, --permissions>

The access permissions associated with the NVRAM area.
The parameter must either be a decimal number or a hexadecimal number staring with '0x'. It is
possible to logically 'or' numbers or strings. The following strings are supported:

=over 4

=item B<AUTHREAD>

Reading requires NVRAM area authorization.

=item B<AUTHWRITE>

Writing requires NVRAM area authorization.

=item B<PPREAD>

Reading requires physical presence.

=item B<PPWRITE>

Writing requires physical presence.

=item B<OWNERREAD>

Reading requires owner authorization.

=item B<OWNERWRITE>

Writing requires owner authorization.

=item B<GLOBALLOCK>

A write to index 0 locks the NVRAM area until the next TPM_Startup(ST_CLEAR)

=item B<READ_STCLEAR>

A read with size 0 on the same index prevents further reading until the next TPM_Startup(ST_CLEAR)

=item B<WRITE_STCLEAR>

A write with size 0 to the same index prevents further writing until the next TPM_Startup(ST_CLEAR)

=item B<WRITEDEFINE>

A write with size 0 to the same index locks the NVRAM area permanently

=item B<WRITEALL>

The value must be written in a single operation

=back

An example of a permission parameter is:

--permissions="OWNERREAD|OWNERWRITE"

=item B<>

=back

=head1 SEE ALSO

B<tpm_nvread>(8), B<tpm_nvwrite>(8), B<tpm_nvrelease>(8), B<tpm_nvinfo>(8)

=head1 REPORTING BUGS

Report bugs to <trousers-users@@lists.sourceforge.net>
@


1.1.1.1.2.1
log
@file tpm_nvdefine.pod was added on branch pgoyette-compat on 2019-01-18 08:48:26 +0000
@
text
@d1 145
@


1.1.1.1.2.2
log
@Synch with HEAD
@
text
@a0 145
=head1 NAME

tpm_nvdefine

=head1 SYNOPSIS

B<tpm_nvdefine [OPTIONS]>

=head1 DESCRIPTION

B<tpm_nvdefine> defines a new NVRAM area at the given index and of given
size. The user has to provide the permissions that control access to
the NVRAM area.

Owner authentication is necessary once the NVRAM area 0xFFFFFFFF has been
defined. The owner password may be provided on the command line using
the owner password option.

The following options are supported:

=over 4

=item B<-h, --help>

Display command usage info.

=item B<-v, --version>

Display command version info.

=item B<-l, --log [none|error|info|debug]>

Set logging level.

=item B<-u, --unicode>

Use TSS UNICODE encoding for passwords to comply with applications
using TSS popup boxes

=item B<-y, --owner-well-known>

Use a secret of all zeros (20 bytes of zeros) as the owner's secret.

=item B<-z, --area-well-known>

Use a secret of all zeros (20 bytes of zeros) as the NVRAM area's secret.

=item B<-o, --pwdo> (optional parameter)

The owner password.

A password may be directly provided for example by using '--pwdo=password' or
'-opassword'. If no password is provided with this option then the program will
prompt the user for the password.

=item B<-a, --pwda> (optional parameter)

The NVRAM area password.

A password may be directly provided for example by using '--pwda=password' or
'-apassword'. If no password is provided with this option then the program will
prompt the user for the password.

=item B<-i, --index>

The index of the NVRAM area.
The parameter must either be a decimal number or a hexadecimal number starting with '0x'.

To select the NVRAM area with index 0x100, the command line parameter should be '-i 0x100' or
'--index 0x100'.

=item B<-s, --size>

The size of the NVRAM area.
The parameter must either be a decimal number or a hexadecimal number starting with '0x'.

=item B<-p, --permissions>

The access permissions associated with the NVRAM area.
The parameter must either be a decimal number or a hexadecimal number staring with '0x'. It is
possible to logically 'or' numbers or strings. The following strings are supported:

=over 4

=item B<AUTHREAD>

Reading requires NVRAM area authorization.

=item B<AUTHWRITE>

Writing requires NVRAM area authorization.

=item B<PPREAD>

Reading requires physical presence.

=item B<PPWRITE>

Writing requires physical presence.

=item B<OWNERREAD>

Reading requires owner authorization.

=item B<OWNERWRITE>

Writing requires owner authorization.

=item B<GLOBALLOCK>

A write to index 0 locks the NVRAM area until the next TPM_Startup(ST_CLEAR)

=item B<READ_STCLEAR>

A read with size 0 on the same index prevents further reading until the next TPM_Startup(ST_CLEAR)

=item B<WRITE_STCLEAR>

A write with size 0 to the same index prevents further writing until the next TPM_Startup(ST_CLEAR)

=item B<WRITEDEFINE>

A write with size 0 to the same index locks the NVRAM area permanently

=item B<WRITEALL>

The value must be written in a single operation

=back

An example of a permission parameter is:

--permissions="OWNERREAD|OWNERWRITE"

=item B<>

=back

=head1 SEE ALSO

B<tpm_nvread>(8), B<tpm_nvwrite>(8), B<tpm_nvrelease>(8), B<tpm_nvinfo>(8)

=head1 REPORTING BUGS

Report bugs to <trousers-users@@lists.sourceforge.net>
@