.Fa nb_iterations
parameters, it should first be decided how long the computation should
take.
-For user authentication, we recommend somewhere between half a second
-(convenient) and several seconds (paranoid).
+For user authentication, values somewhere between half a second
+(convenient) and several seconds (paranoid) are recommended.
The computation should use as much memory as can be spared.
.Pp
Since parameter selection depends on your hardware, some trial and error
.Fn crypto_blake2b_general_init
or
.Fn crypto_blake2b_init ,
-where we set up a context with the hashing parameters;
+which sets up a context with the hashing parameters;
.It
update with
.Fn crypto_blake2b_update ,
-where we hash the message chunk by chunk, and keep the intermediary
+which hashes the message chunk by chunk, and keep the intermediary
result in the context;
.It
and finalisation with
.Fn crypto_blake2b_final ,
-where we produce the final hash.
+which produces the final hash.
The
.Ft crypto_blake2b_ctx
is automatically wiped upon finalisation.
.It
initialisation with
.Fn crypto_hmac_sha512_init ,
-where we set up a context with the hashing parameters;
+which sets up a context with the hashing parameters;
.It
update with
.Fn crypto_hmac_sha512_update ,
-where we hash the message chunk by chunk, and keep the intermediary
+which hashes the message chunk by chunk, and keep the intermediary
result in the context;
.It
and finalisation with
.Fn crypto_hmac_sha512_final ,
-where we produce the final hash.
+which produces the final hash.
The
.Ft crypto_hmac_sha512_ctx
is automatically wiped upon finalisation.
.It
initialisation with
.Fn crypto_sha512_init ,
-where we set up a context with the hashing parameters;
+which sets up a context with the hashing parameters;
.It
update with
.Fn crypto_sha512_update ,
-where we hash the message chunk by chunk, and keep the intermediary
+which hashes the message chunk by chunk, and keep the intermediary
result in the context;
.It
and finalisation with
.Fn crypto_sha512_final ,
-where we produce the final hash.
+which produces the final hash.
The
.Ft crypto_sha512_ctx
is automatically wiped upon finalisation.