> For the complete documentation index, see [llms.txt](https://docs.medcrypt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.medcrypt.com/api-reference/api-reference/classes/structmedcrypt-guardian-utilities-provisionfiles.md).

# medcrypt::guardian::utilities::ProvisionFiles

## Overview

This is the storage for generating provision request files in [GenerateProvisionRequest()](/api-reference/api-reference/classes/classmedcrypt-guardian-guardian.md#step-3-run-generateprovisionrequest).

**Requirements:**

* **Input:** 
  * All `const char*` inputs should be set to the beginning of the loaded buffer. 
  * All `size_t` inputs should be set to the size of the data loaded in the buffer.
* **Output:** 
  * All `char*` outputs should be set to the beginning of an allocated buffer. 
  * All `size_t` outputs should be set to the size of the allocated buffer. After success, they will be set to the size of the data written.

**Usage:** 

* This structure is used with [GenerateProvisionRequest()](/api-reference/api-reference/classes/classmedcrypt-guardian-guardian.md#step-3-run-generateprovisionrequest) to generate provisioning files.
* See GetProvisionFilesFromPath() and DeleteProvisionFileBuffers() in FileHelpers.h for examples.

**Include:**

```cpp
#include <ProvisionFiles.h>
```

**Syntax:**

```cpp
struct medcrypt::guardian::utilities::ProvisionFiles;
```

### Structure members

**Input members:**

* **TrustStore:** Trust store file buffer
* **TrustStoreSize:** Trust store file buffer size
* **PrivateIdentity:** Private identity file buffer
* **PrivateIdentitySize:** Private identity file buffer size
* **CertifiedProfile:** Certified profile file buffer
* **CertifiedProfileSize:** Certified profile file buffer size
* **CertifiedCertificateRevocations:** Certificate revocations file buffer
* **CertifiedCertificateRevocationsSize:** Certificate revocations file buffer size

**Output members:**

* **ProvisionRequest:** Provision request file buffer
* **ProvisionRequestSize:** Provision request file buffer size
* **GeneratedPrivateIdentity:** Generated private identity file buffer
* **GeneratedPrivateIdentitySize:** Generated private identity file buffer size

### Member details

#### Input members:

#### TrustStore

* **Description:** Trust store file buffer.
* **Type:** `const char*`
* **Usage:** Input
* **Syntax:**

```cpp
const char * TrustStore;
```

#### TrustStoreSize

* **Description:** Trust store file buffer size.
* **Type:** `size_t`
* **Usage:** Input
* **Syntax:**

```cpp
size_t TrustStoreSize;
```

#### PrivateIdentity

* **Description:** Private identity file buffer.
* **Type:** `const char*`
* **Usage:** Input
* **Syntax:**

```cpp
const char * PrivateIdentity;
```

#### PrivateIdentitySize

* **Description:** Private identity file buffer size.
* **Type:** `size_t`
* **Usage:** Input
* **Syntax:**

```cpp
size_t PrivateIdentitySize;
```

#### CertifiedProfile

* **Description:** Certified profile file buffer.
* **Type:** `const char*`
* **Usage:** Input
* **Syntax:**

```cpp
const char * CertifiedProfile;
```

#### CertifiedProfileSize

* **Description:** Certified profile file buffer size.
* **Type:** `size_t`
* **Usage:** Input
* **Syntax:**

```cpp
size_t CertifiedProfileSize;
```

#### CertifiedCertificateRevocations

* **Description:** Certificate revocations file buffer.
* **Type:** `const char*`
* **Usage:** Input
* **Syntax:**

```cpp
const char * CertifiedCertificateRevocations;
```

#### CertifiedCertificateRevocationsSize

* **Description:** Certificate revocations file buffer size.
* **Type:** `size_t`
* **Usage:** Input
* **Syntax:**

```cpp
size_t CertifiedCertificateRevocationsSize;
```

#### Output members:

#### ProvisionRequest

* **Description:** Provision request file buffer.
* **Type:** `char*`
* **Usage:** Output
* **Syntax:**

```cpp
char * ProvisionRequest;
```

#### ProvisionRequestSize

* **Description:** Provision request file buffer size.&#x20;
  * **Input:** allocated buffer size.&#x20;
  * **Output:** actual data size written.
* **Type:** `size_t`
* **Usage:** Input/Output
* **Syntax:**

```cpp
size_t ProvisionRequestSize;
```

#### GeneratedPrivateIdentity

* **Description:** Generated private identity file buffer.
* **Type:** `char*`
* **Usage:** Output
* **Syntax:**

```cpp
char * GeneratedPrivateIdentity;
```

#### GeneratedPrivateIdentitySize

* **Description:** Generated private identity file buffer size.&#x20;
  * **Input:** allocated buffer size.&#x20;
  * **Output:** actual data size written.
* **Type:** `size_t`
* **Usage:** Input/Output
* **Syntax:**

```cpp
size_t GeneratedPrivateIdentitySize;
```

### Related classes

* [Guardian class](/api-reference/api-reference/classes/classmedcrypt-guardian-guardian.md#overview): Uses `ProvisionFiles` in [GenerateProvisionRequest()](/api-reference/api-reference/classes/classmedcrypt-guardian-guardian.md#step-3-run-generateprovisionrequest)
* [InitializeFiles struct](/api-reference/api-reference/classes/structmedcrypt-guardian-utilities-initializefiles.md) - Similar file structure used for initialization
* [ProvisionOnlineFiles struct](/api-reference/api-reference/classes/structmedcrypt-guardian-utilities-provisiononlinefiles.md) - File structure used for online provisioning

## Debugging and logging

Guardian does not create log files. Instead, logging is controlled by the application:

* Guardian logs to `stdout` and `stderr`, which appear in the terminal/CLI of the running application during execution. Look for specific error codes or connection failures in the output.
* **Custom logging:** Use `SetLoggingCallback` to redirect log messages to a callback function, stopping terminal output and allowing custom log handling
* **Log control:** Applications can control log level and verbosity.
* **Guardian Cloud UI**: Check the Guardian Cloud interface for additional error details and provisioning status.