May 11, 2003 KVM_NLIST 3

### NAME

kvm_nlist - retrieve symbol table names from a kernel image

### LIBRARY

Kernel Data Access Library (libkvm, -lkvm)

### SYNOPSIS

```int` kvm_nlist(```kvm_t *kd``, struct nlist *nl`)

### DESCRIPTION

kvm_nlist(``) retrieves the symbol table entries indicated by the name list argument ```nl`. This argument points to an array of nlist structures, terminated by an entry whose n_name field is ```NULL` (see nlist(3)). Each symbol is looked up using the n_name field, and if found, the corresponding n_type and n_value fields are filled in. These fields are set to 0 if the symbol is not found.

If ```kd` was created by a call to kvm_open(``) with a ```NULL` executable image name, kvm_nlist(``) will use ```/dev/ksyms` to retrieve the kernel symbol table.

### RETURN VALUES

The kvm_nlist(``) function returns the number of invalid entries found. If the kernel symbol table was unreadable, -1 is returned.

### FILES

```/dev/ksyms`

### SEE ALSO

kvm(3), kvm_close(3), kvm_getargv(3), kvm_getenvv(3), kvm_geterr(3), kvm_getprocs(3), kvm_open(3), kvm_openfiles(3), kvm_read(3), kvm_write(3), ksyms(4)