#include < nvram.h >

Kolom Data
struct hw_device_t	umum

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)

Deskripsi Mendetail

Definisi pada baris 48 file nvram.h .

Dokumentasi Bidang

struct hw_device_t umum

Metode umum nvram_device . ini harus menjadi anggota pertama nvram_device karena pengguna struktur ini akan mentransmisikan hw_device_t ke nvram_device pointer dalam konteks yang diketahui bahwa hw_device_t mereferensikan nvram_device .

Definisi di baris 55 dari file nvram.h .

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)

Membuat ruang baru dengan indeks, ukuran, kontrol, dan nilai otorisasi yang diberikan.

device - Instance nvram_device . index - Indeks untuk ruang baru. Indeks dapat berupa nilai 32-bit, tetapi tidak boleh ditetapkan ke ruang yang ada. size_in_bytes - Jumlah byte yang akan dialokasikan untuk ruang. control_list - Array kontrol yang akan diterapkan untuk ruang. list_size - Jumlah item di |control_list|. authorization_value - Jika |control_list| berisi NV_CONTROL_READ_AUTHORIZATION dan / atau NV_CONTROL_WRITE_AUTHORIZATION, parameter ini akan memberikan nilai otorisasi untuk kebijakan ini (jika kedua kontrol ditetapkan, nilai ini akan berlaku untuk keduanya). Jika tidak, nilai ini akan diabaikan dan dapat berupa NULL. authorization_value_size - Jumlah byte dalam |authorization_value|.

Definisi di baris 187 dari file nvram.h .

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

Menghapus ruang.

device - Instance nvram_device . index - Indeks ruang. authorization_value - Jika ruang memiliki kebijakan NV_CONTROL_WRITE_AUTHORIZATION, parameter ini akan memberikan nilai otorisasi. Jika tidak, nilai ini akan diabaikan dan dapat berupa NULL. authorization_value_size - Jumlah byte dalam |authorization_value|.

Definisi di baris 207 dari file nvram.h .

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

Menonaktifkan pembuatan ruang lebih lanjut hingga reset perangkat penuh berikutnya (seperti reset ke setelan pabrik, bukan mulai ulang). Panggilan berikutnya ke NV_CreateSpace akan menampilkan NV_RESULT_OPERATION_DISABLED.

device - Instance nvram_device .

Definisi di baris 219 dari file nvram.h .

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

Mengaktifkan kunci baca untuk ruang tertentu sesuai dengan kebijakannya. Jika ruang tidak memiliki NV_CONTROL_BOOT_READ_LOCK yang ditetapkan, fungsi ini tidak akan berpengaruh dan dapat menampilkan error.

device - Instance nvram_device . index - Indeks ruang. authorization_value - Jika ruang memiliki kebijakan NV_CONTROL_READ_AUTHORIZATION, parameter ini akan memberikan nilai otorisasi. (Perhatikan bahwa tidak ada persyaratan untuk akses tulis guna mengunci untuk membaca. Kunci baca selalu tidak stabil.) Jika tidak, nilai ini akan diabaikan dan dapat berupa NULL. authorization_value_size - Jumlah byte dalam |authorization_value|.

Definisi di baris 317 dari file nvram.h .

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

Mengaktifkan kunci tulis untuk ruang tertentu sesuai dengan kebijakannya. Jika ruang tidak memiliki NV_CONTROL_PERSISTENT_WRITE_LOCK atau NV_CONTROL_BOOT_WRITE_LOCK yang ditetapkan, fungsi ini tidak akan berpengaruh dan dapat menampilkan error.

device - Instance nvram_device . index - Indeks ruang. authorization_value - Jika ruang memiliki kebijakan NV_CONTROL_WRITE_AUTHORIZATION, parameter ini akan memberikan nilai otorisasi. Jika tidak, nilai ini akan diabaikan dan dapat berupa NULL. authorization_value_size - Jumlah byte dalam |authorization_value|.

Definisi di baris 294 dari file nvram.h .

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

Menampilkan jumlah byte yang tidak dialokasikan yang tersedia di NVRAM. Jika tidak mengetahui ukuran yang tersedia, implementasi dapat memberikan estimasi atau ukuran total.

device - Instance nvram_device . available_size - Menerima output. Tidak boleh NULL.

Definisi di baris 76 dari file nvram.h .

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

Menampilkan jumlah byte maksimum yang dapat dialokasikan untuk satu ruang. Nilai ini akan selalu minimal 32. Jika implementasi tidak membatasi ukuran maksimum, implementasi tersebut dapat memberikan ukuran total.

device - Instance nvram_device . max_space_size - Menerima output. Tidak boleh NULL.

Definisi di baris 87 dari file nvram.h .

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

Menampilkan jumlah total maksimum ruang yang dapat dialokasikan. Jumlah ini akan selalu minimal 8. Menghasilkan NV_UNLIMITED_SPACES jika jumlah ruang yang didukung (hanya dibatasi pada byte NVRAM yang tersedia).

device - Instance nvram_device . num_spaces - Menerima output. Tidak boleh NULL.

Definisi di baris 99 dari file nvram.h .

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)

Menampilkan daftar kontrol yang terkait dengan ruang tertentu.

Definisi di baris 144 dari file nvram.h .

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)

Menampilkan daftar indeks ruang yang dibuat. Jika |max_list_size| adalah 0, hanya |list_size| yang diisi.

Definisi di baris 116 dari file nvram.h .

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

Menampilkan ukuran, dalam byte, dari ruang tertentu.

device - Instance nvram_device . index - Indeks ruang. size - Menerima output. Tidak boleh NULL.

Definisi di baris 128 dari file nvram.h .

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

Menampilkan jumlah total byte yang tersedia di NVRAM. Nilai ini akan selalu minimal 2048. Jika implementasi tidak mengetahui ukuran total, implementasi tersebut dapat memberikan estimasi atau 2048.

device - Instance nvram_device . total_size - Menerima output. Tidak boleh NULL.

Definisi di baris 65 dari file nvram.h .

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

Menampilkan apakah kunci diaktifkan untuk ruang yang ditentukan. Jika kunci diaktifkan, operasi akan dinonaktifkan dan setiap upaya untuk melakukan operasi tersebut akan menghasilkan NV_RESULT_OPERATION_DISABLED.

device - Instance nvram_device . index - Indeks ruang. write_lock_enabled - Akan ditetapkan ke non-nol jika operasi tulis saat ini dinonaktifkan. read_lock_enabled - Akan ditetapkan ke non-nol jika operasi baca saat ini dinonaktifkan.

Definisi di baris 161 dari file nvram.h .

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)

Membaca konten ruang. Jika ruang belum pernah ditulis, semua byte yang dibaca akan menjadi 0x00.

device - Instance nvram_device . index - Indeks ruang. num_bytes_to_read - Jumlah byte yang akan dibaca; |buffer| harus cukup besar untuk menampung jumlah byte ini. Jika lebih besar dari ukuran ruang, seluruh ruang akan dibaca. Jika nilai ini kurang dari ukuran ruang, byte pertama dalam ruang akan dibaca. authorization_value - Jika ruang memiliki kebijakan NV_CONTROL_READ_AUTHORIZATION, parameter ini akan memberikan nilai otorisasi. Jika tidak, nilai ini akan diabaikan dan dapat berupa NULL. authorization_value_size - Jumlah byte dalam |authorization_value|. buffer - Menerima data yang dibaca dari ruang. Ukurannya harus minimal |num_bytes_to_read| byte. bytes_read - Jumlah byte yang dibaca. Jika NV_RESULT_SUCCESS ditampilkan, nilai ini akan ditetapkan ke nilai yang lebih kecil dari |num_bytes_to_read| atau ukuran ruang.

Definisi di baris 272 dari file nvram.h .

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)

Menulis konten ruang. Jika ruang dikonfigurasi dengan NV_CONTROL_WRITE_EXTEND, data input akan digunakan untuk memperluas data saat ini.

device - Instance nvram_device . index - Indeks ruang. buffer - Data yang akan ditulis. buffer_size - Jumlah byte dalam |buffer|. Jika kurang dari ukuran ruang, byte yang tersisa akan ditetapkan ke 0x00. Jika lebih besar dari ukuran ruang, akan menampilkan NV_RESULT_INVALID_PARAMETER. authorization_value - Jika ruang memiliki kebijakan NV_CONTROL_WRITE_AUTHORIZATION, parameter ini akan memberikan nilai otorisasi. Jika tidak, nilai ini akan diabaikan dan dapat berupa NULL. authorization_value_size - Jumlah byte dalam |authorization_value|.

Definisi di baris 241 dari file nvram.h .

Dokumentasi untuk struct ini dibuat dari file berikut:

hardware/libhardware/include/hardware/ nvram.h

Referensi Struct nvram_device

Kolom Data

Deskripsi Mendetail

Dokumentasi Bidang