---
title: IOBSDNameMatching
framework: kernel
role: symbol
role_heading: Function
path: kernel/1575336-iobsdnamematching
---

# IOBSDNameMatching

Create a matching dictionary that specifies an IOService match based on BSD device name.

## Declaration

```occ
OSDictionary * IOBSDNameMatching(const char *name);
```

## Parameters

- `masterPort`: The primary port obtained from IOMasterPort(). Pass kIOMasterPortDefault to look up the default primary port.
- `options`: No options are currently defined.
- `bsdName`: The BSD name, as a const char *.

## Return Value

Return Value The matching dictionary created, is returned on success, or zero on failure. The dictionary is commonly passed to IOServiceGetMatchingServices or IOServiceAddNotification which will consume a reference, otherwise it should be released with CFRelease by the caller.

## Discussion

Discussion IOServices that represent BSD devices have an associated BSD name. This function creates a matching dictionary that will match IOService's with a given BSD name.

## See Also

### Driver Registry

- [IORegistryEntry](kernel/ioregistryentry.md)
- [IORegistryIterator](kernel/ioregistryiterator.md)
- [IOPrintPlane](kernel/1558295-ioprintplane.md)
- [Registry Utilities](kernel/iokit_fundamentals/registry_utilities.md)
- [Registry Keys](kernel/iokit_fundamentals/registry_keys.md)