nvram_device 구조체 참조

데이터 필드
nvram_device 구조체 참조

#include < nvram.h >

데이터 필드

struct hw_device_t   일반적인
 
nvram_result_t (*  get_total_size_in_bytes )(const struct nvram_device *device, uint64_t *total_size)
 
nvram_result_t (*  get_available_size_in_bytes )(const struct nvram_device *device, uint64_t *available_size)
 
nvram_result_t (*  get_max_space_size_in_bytes )(const struct nvram_device *device, uint64_t *max_space_size)
 
nvram_result_t (*  get_max_spaces )(const struct nvram_device *device, uint32_t *num_spaces)
 
nvram_result_t (*  get_space_list )(const struct nvram_device *device, uint32_t max_list_size, uint32_t *space_index_list, uint32_t *list_size)
 
nvram_result_t (*  get_space_size )(const struct nvram_device *device, uint32_t index, uint64_t *size)
 
nvram_result_t (*  get_space_controls )(const struct nvram_device *device, uint32_t index, uint32_t max_list_size, nvram_control_t *control_list, uint32_t *list_size)
 
nvram_result_t (*  is_space_locked )(const struct nvram_device *device, uint32_t index, int *write_lock_enabled, int *read_lock_enabled)
 
nvram_result_t (*  create_space )(const struct nvram_device *device, uint32_t index, uint64_t size_in_bytes, const nvram_control_t *control_list, uint32_t list_size, const uint8_t *authorization_value, uint32_t authorization_value_size)
 
nvram_result_t (*  delete_space )(const struct nvram_device *device, uint32_t index, const uint8_t *authorization_value, uint32_t authorization_value_size)
 
nvram_result_t (*  disable_create )(const struct nvram_device *device)
 
nvram_result_t (*  write_space )(const struct nvram_device *device, uint32_t index, const uint8_t *buffer, uint64_t buffer_size, const uint8_t *authorization_value, uint32_t authorization_value_size)
 
nvram_result_t (*  read_space )(const struct nvram_device *device, uint32_t index, uint64_t num_bytes_to_read, const uint8_t *authorization_value, uint32_t authorization_value_size, uint8_t *buffer, uint64_t *bytes_read)
 
nvram_result_t (*  enable_write_lock )(const struct nvram_device *device, uint32_t index, const uint8_t *authorization_value, uint32_t authorization_value_size)
 
nvram_result_t (*  enable_read_lock )(const struct nvram_device *device, uint32_t index, const uint8_t *authorization_value, uint32_t authorization_value_size)
 

상세 설명

nvram.h 파일의 48 번 라인에 정의가 있습니다.

필드 문서

struct hw_device_t common

nvram_device 의 일반적인 메서드입니다. 이 구조체의 사용자는 hw_device_t 를 hw_device_t 가 nvram_device 를 참조하는 것으로 알려진 컨텍스트에서 nvram_device 포인터로 변환하므로 이 nvram_device 의 첫 번째 구성원이어야 합니다.

nvram.h FILE의 55 라인에 정의가 있습니다.

nvram_result_t (* create_space)(const struct nvram_device *device, uint32_t index, uint64_t size_in_bytes, const nvram_control_t *control_list, uint32_t list_size, const uint8_t *authorization_value, uint32_t authorization_value_size)

지정된 색인, 크기, 컨트롤, 승인 값으로 새 스페이스를 만듭니다.

device - nvram_device 인스턴스입니다. index - 새 스페이스의 색인입니다. 색인은 임의의 32비트 값이 될 수 있지만 아직 기존 공간에 할당되어서는 안 됩니다. size_in_bytes - 공간에 할당할 바이트 수입니다. control_list - 공간에 적용할 컨트롤 배열입니다. list_size - |control_list|의 항목 수입니다. authorization_value - |control_list| 에 NV_CONTROL_READ_AUTHORIZATION 또는 NV_CONTROL_WRITE_AUTHORIZATION이 포함된 경우 이 매개변수는 이러한 정책의 승인 값을 제공합니다. 두 컨트롤이 모두 설정된 경우 이 값은 두 컨트롤 모두에 적용됩니다. 그 외의 경우에는 이 값이 무시되며 NULL일 수 있습니다. authorization_value_size - |authorization_value|의 바이트 수입니다.

nvram.h FILE의 187 행에 정의가 있습니다.

nvram_result_t (* delete_space)(const struct nvram_device *device, uint32_t index, const uint8_t *authorization_value, uint32_t authorization_value_size)

스페이스를 삭제합니다.

device - nvram_device 인스턴스입니다. index - 스페이스 색인입니다. authorization_value - 스페이스에 NV_CONTROL_WRITE_AUTHORIZATION 정책이 있는 경우 이 매개변수는 승인 값을 제공합니다. 그 외의 경우에는 이 값이 무시되며 NULL일 수 있습니다. authorization_value_size - |authorization_value|의 바이트 수입니다.

nvram.h FILE의 207 라인에 정의가 있습니다.

nvram_result_t (* disable_create)(const struct nvram_device *device)

다음번 전체 기기 초기화 (재부팅이 아닌 공장 초기화)까지 스페이스 생성을 사용 중지합니다. 후속 NV_CreateSpace 호출은 NV_RESULT_OPERATION_DISABLED를 반환해야 합니다.

device - nvram_device 인스턴스입니다.

nvram.h FILE의 219 라인에 정의가 있습니다.

nvram_result_t (* enable_read_lock)(const struct nvram_device *device, uint32_t index, const uint8_t *authorization_value, uint32_t authorization_value_size)

정책에 따라 지정된 스페이스에 대한 읽기 잠금을 사용 설정합니다. 공간에 NV_CONTROL_BOOT_READ_LOCK이 설정되어 있지 않으면 이 함수는 아무런 영향을 미치지 않으며 오류를 반환할 수 있습니다.

device - nvram_device 인스턴스입니다. index - 스페이스 색인입니다. authorization_value - 스페이스에 NV_CONTROL_READ_AUTHORIZATION 정책이 있는 경우 이 매개변수는 승인 값을 제공합니다. 읽기 잠금을 설정하기 위해 쓰기 액세스 권한이 필요하지는 않습니다. 읽기 잠금은 항상 휘발성입니다.) 그 외의 경우에는 이 값이 무시되며 NULL일 수 있습니다. authorization_value_size - |authorization_value|의 바이트 수입니다.

nvram.h FILE의 317 행에 정의가 있습니다.

nvram_result_t (* enable_write_lock)(const struct nvram_device *device, uint32_t index, const uint8_t *authorization_value, uint32_t authorization_value_size)

정책에 따라 지정된 스페이스에 쓰기 잠금을 사용 설정합니다. 스페이스에 NV_CONTROL_PERSISTENT_WRITE_LOCK 또는 NV_CONTROL_BOOT_WRITE_LOCK이 설정되어 있지 않으면 이 함수는 효과가 없으며 오류를 반환할 수 있습니다.

device - nvram_device 인스턴스입니다. index - 스페이스 색인입니다. authorization_value - 스페이스에 NV_CONTROL_WRITE_AUTHORIZATION 정책이 있는 경우 이 매개변수는 승인 값을 제공합니다. 그 외의 경우에는 이 값이 무시되며 NULL일 수 있습니다. authorization_value_size - |authorization_value|의 바이트 수입니다.

nvram.h FILE의 294 라인에 정의가 있습니다.

nvram_result_t (* get_available_size_in_bytes)(const struct nvram_device *device, uint64_t *available_size)

NVRAM에서 할당되지 않은 바이트 수를 출력합니다. 구현에서 사용 가능한 크기를 알지 못하는 경우 추정치 또는 총 크기를 제공할 수 있습니다.

device - nvram_device 인스턴스입니다. available_size - 출력을 수신합니다. NULL이 될 수 없습니다.

nvram.h FILE의 76 행에 정의가 있습니다.

nvram_result_t (* get_max_space_size_in_bytes)(const struct nvram_device *device, uint64_t *max_space_size)

단일 공간에 할당할 수 있는 최대 바이트 수를 출력합니다. 이 값은 항상 32 이상입니다. 구현에서 최대 크기를 제한하지 않으면 총 크기를 제공할 수 있습니다.

device - nvram_device 인스턴스입니다. max_space_size - 출력을 수신합니다. NULL이 될 수 없습니다.

nvram.h FILE의 87 라인에 정의가 있습니다.

nvram_result_t (* get_max_spaces)(const struct nvram_device *device, uint32_t *num_spaces)

할당할 수 있는 총 최대 스페이스 수를 출력합니다. 이 값은 항상 8 이상입니다. 지원되는 스페이스 수가 있는 경우 NV_UNLIMITED_SPACES를 출력합니다 (사용 가능한 NVRAM 바이트에만 제한됨).

device - nvram_device 인스턴스입니다. num_spaces - 출력을 수신합니다. NULL이 될 수 없습니다.

nvram.h FILE의 99 줄에 정의가 있습니다.

nvram_result_t (* get_space_controls)(const struct nvram_device *device, uint32_t index, uint32_t max_list_size, nvram_control_t *control_list, uint32_t *list_size)

지정된 스페이스와 연결된 컨트롤 목록을 출력합니다.

device - nvram_device 인스턴스입니다. index - 공간 색인입니다. max_list_size - |control_list| 배열의 항목 수입니다. control_list - 지정된 |max_list_size|까지의 컨트롤 목록을 수신합니다. |max_list_size| 가 0인 경우 NULL일 수 있습니다. list_size - |control_list|에 채워진 항목 수 또는 |control_list| 가 NULL인 경우 사용 가능한 항목 수를 수신합니다.

nvram.h 파일의 144 행에 정의되어 있습니다.

nvram_result_t (* get_space_list)(const struct nvram_device *device, uint32_t max_list_size, uint32_t *space_index_list, uint32_t *list_size)

생성된 스페이스 색인의 목록을 출력합니다. |max_list_size| 가 0이면 |list_size| 만 채워집니다.

device - nvram_device 인스턴스입니다. max_list_size - |space_index_list| 배열의 항목 수입니다. space_index_list - 지정된 |max_list_size|까지 생성된 공간 목록을 수신합니다. |max_list_size| 가 0인 경우 NULL일 수 있습니다. list_size - |space_index_list|에 채워진 항목 수 또는 |space_index_list| 가 NULL인 경우 사용 가능한 항목 수를 수신합니다.

nvram.h FILE의 116 라인에 정의가 있습니다.

nvram_result_t (* get_space_size)(const struct nvram_device *device, uint32_t index, uint64_t *size)

지정된 공간의 크기를 바이트 단위로 출력합니다.

device - nvram_device 인스턴스입니다. index - 공간 색인입니다. size - 출력을 수신합니다. NULL이 될 수 없습니다.

nvram.h FILE의 128 행에 정의되어 있습니다.

nvram_result_t (* get_total_size_in_bytes)(const struct nvram_device *device, uint64_t *total_size)

NVRAM에서 사용 가능한 총 바이트 수를 출력합니다. 이 값은 항상 2,048 이상입니다. 구현에서 총 크기를 모르는 경우 추정치 또는 2048을 제공할 수 있습니다.

device - nvram_device 인스턴스입니다. total_size - 출력을 수신합니다. NULL이 될 수 없습니다.

nvram.h FILE의 65 라인에 정의가 있습니다.

nvram_result_t (* is_space_locked)(const struct nvram_device *device, uint32_t index, int *write_lock_enabled, int *read_lock_enabled)

지정된 공간에 도어락이 사용 설정되어 있는지 출력합니다. 잠금이 사용 설정되면 작업이 사용 중지되며 이 작업을 실행하려고 하면 NV_RESULT_OPERATION_DISABLED가 발생합니다.

device - nvram_device 인스턴스입니다. index - 공간 색인입니다. write_lock_enabled - 쓰기 작업이 현재 사용 중지된 경우에만 0이 아닌 값으로 설정됩니다. read_lock_enabled - 읽기 작업이 현재 사용 중지된 경우에만 0이 아닌 값으로 설정됩니다.

nvram.h FILE의 161 라인에 정의가 있습니다.

nvram_result_t (* read_space)(const struct nvram_device *device, uint32_t index, uint64_t num_bytes_to_read, const uint8_t *authorization_value, uint32_t authorization_value_size, uint8_t *buffer, uint64_t *bytes_read)

스페이스의 콘텐츠를 읽습니다. 공간에 쓴 적이 없다면 읽은 모든 바이트가 0x00입니다.

device - nvram_device 인스턴스입니다. index - 공간 색인입니다. num_bytes_to_read - 읽을 바이트 수입니다. |buffer| 는 이 정도의 바이트 수를 수용할 만큼 커야 합니다. 이 값이 스페이스 크기보다 크면 전체 스페이스가 읽힙니다. 이 값이 스페이스 크기보다 작으면 스페이스의 첫 번째 바이트가 읽힙니다. authorization_value - 스페이스에 NV_CONTROL_READ_AUTHORIZATION 정책이 있는 경우 이 매개변수는 승인 값을 제공합니다. 그렇지 않으면 이 값은 무시되며 NULL일 수 있습니다. authorization_value_size - |authorization_value|의 바이트 수입니다. buffer - 스페이스에서 읽은 데이터를 수신합니다. 크기가 |num_bytes_to_read| 바이트 이상이어야 합니다. bytes_read - 읽은 바이트 수입니다. NV_RESULT_SUCCESS가 반환되면 |num_bytes_to_read| 또는 공간 크기 중 더 작은 값으로 설정됩니다.

nvram.h 파일의 272 줄에 정의가 있습니다.

nvram_result_t (* write_space)(const struct nvram_device *device, uint32_t index, const uint8_t *buffer, uint64_t buffer_size, const uint8_t *authorization_value, uint32_t authorization_value_size)

스페이스의 콘텐츠를 씁니다. 공간이 NV_CONTROL_WRITE_EXTEND로 구성된 경우 입력 데이터가 현재 데이터를 확장하는 데 사용됩니다.

device - nvram_device 인스턴스입니다. index - 공간 색인입니다. buffer - 쓸 데이터입니다. buffer_size - |buffer|의 바이트 수입니다. 이 값이 공간 크기보다 작으면 나머지 바이트는 0x00으로 설정됩니다. 이 값이 스페이스 크기보다 크면 NV_RESULT_INVALID_PARAMETER가 반환됩니다. authorization_value - 스페이스에 NV_CONTROL_WRITE_AUTHORIZATION 정책이 있는 경우 이 매개변수는 승인 값을 제공합니다. 그 외의 경우에는 이 값이 무시되며 NULL일 수 있습니다. authorization_value_size - |authorization_value|의 바이트 수입니다.

nvram.h FILE의 241 라인에 정의가 있습니다.

이 구조체에 관한 문서는 다음 파일에서 생성되었습니다.
  • hardware/libhardware/include/hardware/ nvram.h