1# zx_cprng_add_entropy
2
3## NAME
4
5<!-- Updated by update-docs-from-abigen, do not edit. -->
6
7cprng_add_entropy - Add entropy to the kernel CPRNG
8
9## SYNOPSIS
10
11<!-- Updated by update-docs-from-abigen, do not edit. -->
12
13```
14#include <zircon/syscalls.h>
15
16zx_status_t zx_cprng_add_entropy(const void* buffer, size_t buffer_size);
17```
18
19## DESCRIPTION
20
21`zx_cprng_add_entropy()` mixes the given entropy into the kernel CPRNG.
22a privileged operation.  It will accept at most **ZX_CPRNG_ADD_ENTROPY_MAX_LEN**
23bytes of entropy at a time.
24
25## RIGHTS
26
27<!-- Updated by update-docs-from-abigen, do not edit. -->
28
29TODO(ZX-2399)
30
31## RETURN VALUE
32
33`zx_cprng_add_entropy()` returns **ZX_OK** on success.
34
35## ERRORS
36
37**ZX_ERR_INVALID_ARGS** *buffer_size* is too large, or *buffer* is not a valid
38userspace pointer.
39
40## BUGS
41
42This syscall should be very privileged.
43