|
Size: 1801
Comment:
|
Size: 2082
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| ## page was renamed from Linux/nsswitch.conf | |
| Line 2: | Line 3: |
A description of the '''Name Service Switch''' ('''NSS''') file (`/etc/nsswitch.conf`). For more details, see `nsswitch.conf(5)`. |
|
| Line 31: | Line 34: |
| The first column (delimited by spaces or tab characters) indicates a database, while every subsequent column is a source. Some common database sources are listed below. For `hosts`... * `files` (i.e. `/etc/hosts`) * `dns` (i.e. run-time lookups based on `/etc/resolv.conf`) * `myhostname` (see `nss-myhostname(8)`) * `mymachine` which connects to `systemd-machined` (see `nss-mymachines(8)`) * `resolve` which connects to `systemd-resolved` (see `nss-resolve(8)`) ---- |
The first column (delimited by spaces or tab characters) indicates a '''database''', while every subsequent column is a '''service specification''' or '''optional action'''. |
| Line 44: | Line 38: |
| === Action Items === | === Service Specifications === |
| Line 46: | Line 40: |
| '''Action items''' follow one the following patterns: `[STATUS=ACTION]` and `[!STATUS=ACTION]`. | Common service specifications are: |
| Line 48: | Line 42: |
| `STATUS` can be any of... | * `files` (i.e. `/etc/hosts`) * `dns` (i.e. runtime lookups based on `/etc/resolv.conf`) * `myhostname` (see `nss-myhostname(8)`) * `mymachine` which connects to [[Linux/SystemdMachined|systemd-machined]] (see `nss-mymachines(8)`) * `resolve` which connects to [[Linux/SystemdResolved|systemd-resolved]] (see `nss-resolve(8)`) === Optional Actions === Option actions follow the pattern of `[STATUS=ACTION]` and `[!STATUS=ACTION]`. A '''status''' can be any of: |
| Line 54: | Line 61: |
| `ACTION` can be any of... | An '''action''' can be any of: |
| Line 57: | Line 65: |
| * `merge` causes the system to try both the preceding and the following items, and | * `merge` causes the system to try both the preceding and the following items |
| Line 59: | Line 67: |
| By default, only a `success` status results in a `return` action. Anything else will result in a `continue`. The exception is for a `group` lookup-a `notfound` status will lead to a `continue` action regardless of any action specified. | By default, only a `success` status results in a `return` action. Anything else will result in a `continue`. The exception the `group` database, where a `notfound` status will lead to a `continue` action regardless of any action specified. |
nsswitch.conf
A description of the Name Service Switch (NSS) file (/etc/nsswitch.conf). For more details, see nsswitch.conf(5).
Example
passwd: compat group: compat shadow: compat hosts: dns [!UNAVAIL=return] files networks: nis [NOTFOUND=return] files ethers: nis [NOTFOUND=return] files protocols: nis [NOTFOUND=return] files rpc: nis [NOTFOUND=return] files services: nis [NOTFOUND=return] files
Syntax
Databases
The first column (delimited by spaces or tab characters) indicates a database, while every subsequent column is a service specification or optional action.
Service Specifications
Common service specifications are:
files (i.e. /etc/hosts)
dns (i.e. runtime lookups based on /etc/resolv.conf)
myhostname (see nss-myhostname(8))
mymachine which connects to systemd-machined (see nss-mymachines(8))
resolve which connects to systemd-resolved (see nss-resolve(8))
Optional Actions
Option actions follow the pattern of [STATUS=ACTION] and [!STATUS=ACTION].
A status can be any of:
success meaning 'no error'.
notfound meaning 'error in lookup'.
unavail indicates a connection couldn't be made.
tryagain indicates 'temporarily unavailability', as with locked connections.
An action can be any of:
return meaning 'return the result'
continue meaning 'try the next item'
merge causes the system to try both the preceding and the following items
By default, only a success status results in a return action. Anything else will result in a continue. The exception the group database, where a notfound status will lead to a continue action regardless of any action specified.