stationlist.xml

package: tvtime

title: stationlist.xml(5)

summary: tvtime station configuration file

text:
# stationlist.xml(5)

## NAME
stationlist.xml - tvtime station configuration file

## SYNOPSIS
~/.config/tvtime/stationlist.xml

## DESCRIPTION
The stationlist.xml file contains the configuration of channel information for capture cards with tuners. It contains a list of active channels along with their frequencies, renumbering information, and channel name. The stationlist.xml file is updated by tvtime at runtime to store settings across sessions. For this reason, you should not edit this file while tvtime is running, as your changes may be overwritten.

This file is created or updated whenever channel information is changed in tvtime. This is done when renumbering a channel, using the channel scanner, or manually activating or deactivating a specific channel from the list.

Channel settings are saved specific to norm and frequency table.

<?xml version="1.0"?>

<!DOCTYPE stationlist PUBLIC "-//tvtime//DTD stationlist 1.0//EN"

"http://tvtime.sourceforge.net/DTD/stationlist.dtd">

<stationlist xmlns="http://tvtime.sourceforge.net/DTD/">

<list norm="NTSC" frequencies="US-Cable">

<station ... />

... station list

</list>

</stationlist>

That is, each norm/frequency combination will get its own section in the configuration file. The frequencies name is not special, you can have frequencies="foobar" and running

tvtime -f foobar

will do the right thing. The norm, however, must match the norm being used.

Entries in a list are in the following form:

<station name="CNN" active="1" position="18"

band="US Cable" channel="18"/>

<station name="DSF" active="1" position="12"

band="VHF E2-E12" channel="E12"/>

## STATIONS
Each station has its own properties that should be set.

name

The human-readable name of the current station.

active

When set to 1, the channel is active. To deactivate the channel, set this value to 0.

position

This setting specifies the position the channel occupies on the dial. This allows users to arbitrarily map any particular channel to a particular position on the dial.

band

channel

The possible bands and channels available in tvtime are:

Band name

Channels provided

US Cable

1–99

US Cable 100

100–125

US Two-Way

T7, T8, T9, T10, T11, T12 T13, T14

US Broadcast

2–83

China Broadcast

1–68, A1–A7, B1–B31, C1–C5

Japan Broadcast

1–62

Japan Cable

13–63

VHF E2-E12

E1–E12

VHF S1-S41

S1–S41

VHF Misc

X, Y, Z, Z+1, Z+2

VHF France

K01–K10, KB–KQ, H01–H19

VHF Russia

R1–R12, SR1–SR19

VHF Australia

AS1–AS12, AS5A, AS9A

VHF Italy

A–H, H1, H2

VHF Ireland

I1–I9

VHF South Africa

1–13

UHF

U21–U69

UHF Australia

AU28–AU69

Australia Optus

01–058

Custom channels can be included manually by specifying the frequency in megahertz:

<station name="2" active="1" position="0"

band="Custom" channel="55.69MHz"/>

norm

A per-channel norm can be specified in the stationlist. This is for stations which receive both PAL and SECAM stations, such that they can choose the colour encoding format per-channel. The only valid values here are either PAL or SECAM.

network

Sets the name of the network for the OSD display. In NTSC regions, this is set from the XDS information in the VBI if VBI decoding is enabled.

call

Sets the call letters of the network for the OSD display. In NTSC regions, this is set from the XDS information in the VBI if VBI decoding is enabled.

xmltvid

Sets the XMLTV channel identifier to associate this channel with if tvtime cannot automatically make the association. For following channel definition in an XMLTV file:

<channel id="I10119.labs.zap2it.com">

<display-name>CICA</display-name>

<display-name>TV Ontario (CICA)</display-name>

<display-name>Canadian Independent</display-name>

</channel>

An associated stationlist entry would be:

<station name="2" active="1" position="0"

band="Custom" channel="55.69MHz"

xmltvid="I10119.labs.zap2it.com"/>

## AUTHORS
Achim Schneider, Billy Biggs.

## SEE ALSO
tvtime(1), tvtime-command(1), tvtime-scanner(1), tvtime.xml(5).


tvtime.xml

title: tvtime.xml(5)

summary: tvtime configuration file

text:
# tvtime.xml(5)

## NAME
tvtime.xml - tvtime configuration file

## SYNOPSIS
~/.config/tvtime/tvtime.xml

/etc/tvtime/tvtime.xml

## DESCRIPTION
The tvtime.xml file is the main configuration file for tvtime. It contains all of the default settings and key bindings. The tvtime.xml file is updated by tvtime at runtime, to store settings across sessions. For this reason, you should not edit the tvtime.xml file while tvtime is running, as your changes may be overwritten.

The global syntax is as follows:

<?xml version="1.0"?>

<!DOCTYPE tvtime PUBLIC "-//tvtime//DTD tvtime 1.0//EN"

"http://tvtime.sourceforge.net/DTD/tvtime1.dtd">

<tvtime xmlns="http://tvtime.sourceforge.net/DTD/">

</tvtime>

You can find the DTD and other information about the XML configuration files at http://tvtime.sourceforge.net/DTD/

## OPTIONS
tvtime supports a multitude of options. The <option> tag should be contained within a <tvtime> tag.

The following is a list of options and their default values, along with a description of what the option does.

<option name="Verbose" value="0"/>

The verbose setting indicates that we should print full informational and warning messages to stderr while running tvtime. Otherwise, only fatal errors will be printed to the output.

<option name="V4LDevice" value="/dev/video0"/>

This sets the default capture device to use.

<option name="V4LInput" value="0"/>

This sets the default capture card input to be opened by tvtime. For example, for my WinTV card has the tuner as source 0, and its composite input as source 1. Sources can be changed at runtime using the toggle_input command, which is key command “i” by default.

<option name="Norm" value="NTSC"/>

This sets the default TV norm. Valid options are: •

NTSC

•

NTSC-JP

•

SECAM

•

PAL

•

PAL-Nc

•

PAL-M

•

PAL-N

•

PAL-60

<option name="SaveAndRestorePictureSettings" value="1"/>

This option indicates whether tvtime should enable its own saving and restoring of picture settings, both on startup and per channel change.

<option name="AudioMode" value="stereo"/>

This option saves the last used audio mode. This will be used to remember which audio mode to select when the application is next started. Valid options here are "mono", "stereo", "lang1", "lang2" or "sap".

<option name="AudioBoost" value="-1"/>

This option sets the audio boost. This is a percentage for how much to set the volume coming out of the capture card. By default, tvtime does not set the audio at all. However, because the volume sometimes does not have a sane default, or is reset by other applications, you can use this value to have it always set to your favorite volume. Use -1 to have tvtime not touch the volume.

<option name="ShowCC" value="0"/>

This option saves the state of closed caption decoding. Closed captions are an NTSC-specific text version of the audio for the hearing impaired.

<option name="ColourInvert" value="0"/>

This value saves the on-off state of the colour invert filter across sessions.

<option name="MirrorInput" value="0"/>

This value saves the on-off state of the mirror filter across sessions.

<option name="Frequencies" value="US-Cable"/>

This sets the default frequency table to use for any tuners found. Possibilities are: •

us-cable

•

us-broadcast

•

japan-cable

•

japan-broadcast

•

europe

•

australia

•

australia-optus

•

newzealand

•

france

•

russia

<option name="NTSCCableMode" value="Standard"/>

There are two special NTSC cable standards in the US: IRC and HRC. In IRC, channels 5 and 6 are on different frequencies, and HRC mode shifts all frequencies up by 1.25MHz (and is also weird on channels 5 and 6). Use this option to set the cable mode to Standard, IRC, or HRC. It is very rare that you will see cable systems that use IRC or HRC cable.

<option name="CheckForSignal" value="1"/>

Toggle whether tvtime should check if there is a signal present when changing channels etc. If your card doesn't suck, you shouldn't need to shut this off. Disabling this feature will also disable the channel scanner.

<option name="InputWidth" value="720"/>

This sets how many pixels per scanline to request from the capture card. A higher setting gives better quality, while a lower setting means we do less work, and so tvtime will run faster. If you have a slower CPU (like, less than 500Mhz or so), maybe values of 480 or 400 might suit you best. For best quality, choose a high value like 720 or 768. Most capture cards cannot sample higher than 768 pixels per scanline.

<option name="XMLTVFile" value="none"/>

Set this to a filename to get show listings from an xmltv file. Set to "none" if you do not wish to use xmltv.

<option name="XMLTVLanguage" value="none"/>

Set this to a two-letter language code to set the language to use for entries in the XMLTV file (for example, use "de" for German). Set to "none" if you wish to use the default language of the file.

<option name="UseXDS" value="0"/>

Set this to 1 to enable XDS channel information decoding. This option is specific to NTSC regions. XDS is used to send information about the channel including the network name and call letters, and sometimes information about the current show.

<option name="VBIDevice" value="/dev/vbi0"/>

This sets which device to use for VBI decoding.

<option name="MixerDevice" value="/dev/mixer:line"/>

This sets the mixer device and channel to use. The format is device name:channel name for OSS mixer (e.g., "/dev/mixer:Line") or device/channel for ALSA (e.g., "hw:0/CD"). Valid OSS channels are:

vol, bass, treble, synth, pcm, speaker, line, mic, cd, mix, pcm2, rec, igain, ogain, line1, line2, line3, dig1, dig2, dig3, phin, phout, video, radio, monitor

<option name="SquarePixels" value="1"/>

Disabling this option tells tvtime to use the X server DPI to determine pixel shape. By default, tvtime assumes pixels are square. Set this to 0 if you have a 4:3 monitor but run it at 1280x1024 and want tvtime to do the right thing.

<option name="Widescreen" value="0"/>

This option enables 16:9 aspect ratio mode by default on startup.

<option name="WindowGeometry" value="0x576"/>

Sets the geometry of the window. A width value of 0 signifies that the appropriate width for the given height will be used. For 4:3 content on a square pixel display, this defaults to a 768×576 window.

<option name="Overscan" value="0.0"/>

This sets the percent of the sides to leave to the overscan, that is, don't show them at all. Safe action area on a television is 10% in the overscan, but that's a bit restrictive. If you want tvtime to look like a TV, a good value would be about 6–8%. The value is in percent, so for 8%, use 8.0.

<option name="Fullscreen" value="0"/>

Set this to 1 to have tvtime start in fullscreen mode. This setting is set at runtime so that when you quit tvtime in fullscreen, starting it again will start back in fullscreen mode.

<option name="AlwaysOnTop" value="0"/>

Set this to 1 to have tvtime start in always-on-top mode under supporting window managers. This setting is set at runtime so that when you quit tvtime in always-on-top mode, starting it again will start back in always-on-top mode.

<option name="FullscreenPosition" value="Centre"/>

Sets the position of the output when in fullscreen mode: top, bottom or centre. When set to top, tvtime in fullscreen will place its output at the top of the screen. Use if you have a projector to help tvtime fit properly onto your screen.

<option name="FramerateMode" value="0"/>

This sets the framerate of the output from tvtime.

0

Full framerate mode, every field is deinterlaced. 59.94fps for NTSC, 50fps for PAL.

1

Half framerate mode, deinterlace every top field to a frame (TFF). 29.97fps for NTSC, 25fps for PAL.

2

Half framerate mode, deinterlace every bottom field to a frame (BFF). 29.97fps for NTSC, 25fps for PAL.

The two half framerate modes are useful for progressive content from video game consoles. Use weave and select either TFF or BFF, whichever does not exhibit interlace effects.

<option name="QuietScreenshots" value="0"/>

When this option is turned on, screenshots will not announce themselves on the OSD. This is useful if you intend to take a lot of screenshots, and don't want the text to interrupt your TV watching or appear in other screenshots.

<option name="ProcessPriority" value="-10"/>

Sets the default process priority. By default, tvtime tries to set itself at a priority of –10 which higher than normal applications. Acceptable values are from –20 to 20, with lower values meaning higher priority.

<option name="TimeFormat" value="%X"/>

Sets the time format to be used in the tvtime on-screen display. The format is a string in the same format as strftime(3). The default is to use the time format of your locale.

<option name="ScreenShotDir" value="~"/>

This is the default directory in which screenshots are placed. The default is to save them into the user's home directory.

<option name="ChannelTextFG" value="0xFFFFFF00"/>

<option name="OtherTextFG" value="0xFFF5DEB3"/>

These options set the ARGB colours used for the text in the on-screen display. The default for the channel name is “yellow” (0xffffff00), and the default for the surrounding text is “wheat” (0xfff5deb3). The colour format can be hexadecimal or decimal. If the alpha channel is not specified the default is “opaque” (255).

Examples:

0xffaadd, 0xff0000ff, 0xff, 0xffff, 255 255 0, 0, 16777215.

<option name="UnmuteVolume" value="-1"/>

This setting saves the volume before muting across tvtime sessions. You should not ever need to set this yourself.

<option name="Muted" value="0"/>

This setting saves whether or not tvtime was muted when it was last exited. You should not ever need to set this yourself.

<option name="MuteOnExit" value="0"/>

This setting controls whether tvtime should mute its mixer device on exit. Use this to work around noisy capture cards.

<option name="ShowTaglines" value="1"/>

This setting controls whether tvtime should show the silly taglines in the window title bar. Set to 0 to shut them off.

<option name="PrevChannel" value="2"/>

This setting is saved at runtime to remember the previous channel.

<option name="Channel" value="2"/>

This setting is saved at runtime to remember the current channel.

<option name="DeinterlaceMethod" value="AdaptiveAdvanced"/>

This setting is saved at runtime to remember the deinterlacer used. Supported deinterlacers are:

TelevisionFull

Television: Full Resolution

TelevisionHalf

Television: Half Resolution

BlurVertical

Blur: Vertical

BlurTemporal

Blur: Temporal

AdaptiveSearch

Motion Adaptive: Motion Search

AdaptiveAdvanced

Motion Adaptive: Advanced Detection

AdaptiveSimple

Motion Adaptive: Simple Detection

ProgressiveTFF

Progressive: Top Field First

ProgressiveBFF

Progressive: Bottom Field First

## BINDINGS
Key presses and mouse button clicks can be mapped to tvtime commands. For a description of each command, see tvtime-command(1).

Multiple keys and mouse buttons may be bound to the same command. For convenience, tvtime supplies aliases for special keys. The special keys known to tvtime are:

Up, Down, Left, Right, Insert, Home, End,R PageUp, PageDown, F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, F13, F14, F15, Backspace, Escape, Enter, Print, Menu

An example key binding would be for the command CHANNEL_INC. In this case, we have two keys (Up and k) bound to the command as well as a mouse button (4).

<bind command="channel_inc">

<keyboard key="up"/>

<keyboard key="k"/>

<mouse button="4"/>

</bind>

Some commands can take arguments, for example, the SCREENSHOT command can take an argument for the filename. Arguments can be given to a key binding as follows:

<bind command="screenshot" argument="/tmp/last-screenshot.png">

<keyboard key="s"/>

</bind>

## AUTHOR
Billy Biggs.

## SEE ALSO
tvtime(1), tvtime-configure(1), tvtime-command(1), tvtime-scanner(1), stationlist.xml(5).


systemd.device

package: udev

title: systemd.device(5)

summary: Device unit configuration

text:
# systemd.device(5)

## NAME
systemd.device - Device unit configuration

## SYNOPSIS
device.device

## DESCRIPTION
A unit configuration file whose name ends in ".device" encodes information about a device unit as exposed in the sysfs/udev(7) device tree. This may be used to define dependencies between devices and other units.

This unit type has no specific options. See systemd.unit(5) for the common options of all unit configuration files. The common configuration items are configured in the generic [Unit] and [Install] sections. A separate [Device] section does not exist, since no device-specific options may be configured.

systemd will dynamically create device units for all kernel devices that are marked with the "systemd" udev tag (by default all block and network devices, and a few others). Note that if systemd-udev.service is not running, no device units will be available (for example in a typical container).

Device units are named after the /sys/ and /dev/ paths they control. Example: the device /dev/sda5 is exposed in systemd as dev-sda5.device. For details about the escaping logic used to convert a file system path to a unit name see systemd.unit(5).

To tag a udev device, use "TAG+="systemd"" in the udev rules file, see udev(7) for details.

Device units will be reloaded by systemd whenever the corresponding device generates a "changed" event. Other units can use ReloadPropagatedFrom= to react to that event.

## AUTOMATIC DEPENDENCIES

### Implicit Dependencies
Many unit types automatically acquire dependencies on device units of devices they require. For example, .socket unit acquire dependencies on the device units of the network interface specified in BindToDevice=. Similar, swap and mount units acquire dependencies on the units encapsulating their backing block devices.

### Default Dependencies
There are no default dependencies for device units.

## THE UDEV DATABASE
Unit settings of device units may either be configured via unit files, or directly from the udev database. The following udev device properties are understood by the service manager:

SYSTEMD_WANTS=, SYSTEMD_USER_WANTS=

Adds dependencies of type Wants= from the device unit to the specified units. SYSTEMD_WANTS= is read by the system service manager, SYSTEMD_USER_WANTS= by user service manager instances. These properties may be used to activate arbitrary units when a specific device becomes available. Note that this and the other udev device properties are not taken into account unless the device is tagged with the "systemd" tag in the udev database, because otherwise the device is not exposed as a systemd unit (see above).

Note that systemd will only act on Wants= dependencies when a device first becomes active. It will not act on them if they are added to devices that are already active. Use SYSTEMD_READY= (see below) to configure when a udev device shall be considered active, and thus when to trigger the dependencies.

The specified property value should be a space-separated list of valid unit names. If a unit template name is specified (that is, a unit name containing an "@" character indicating a unit name to use for multiple instantiation, but with an empty instance name following the "@"), it will be automatically instantiated by the device's "sysfs" path (that is: the path is escaped and inserted as instance name into the template unit name). This is useful in order to instantiate a specific template unit once for each device that appears and matches specific properties.

SYSTEMD_ALIAS=

Adds an additional alias name to the device unit. This must be an absolute path that is automatically transformed into a unit name. (See above.)

SYSTEMD_READY=

If set to 0, systemd will consider this device unplugged even if it shows up in the udev tree. If this property is unset or set to 1, the device will be considered plugged if it is visible in the udev tree. This option is useful for devices that initially show up in an uninitialized state in the tree, and for which a "changed" event is generated the moment they are fully set up. Note that SYSTEMD_WANTS= (see above) is not acted on as long as SYSTEMD_READY=0 is set for a device.

ID_MODEL_FROM_DATABASE=, ID_MODEL=

If set, this property is used as description string for the device unit.

## SEE ALSO
systemd(1), systemctl(1), systemd.unit(5), udev(7), systemd.directives(7)


systemd.link

title: systemd.link(5)

summary: Network device configuration

text:
# systemd.link(5)

## NAME
systemd.link - Network device configuration

## SYNOPSIS
link.link

## DESCRIPTION
A plain ini-style text file that encodes configuration for matching network devices, used by systemd-udevd(8) and in particular its net_setup_link builtin. See systemd.syntax(7) for a general description of the syntax.

The link files are read from the files located in the system network directory /lib/systemd/network, the volatile runtime network directory /run/systemd/network, and the local administration network directory /etc/systemd/network. Link files must have the extension .link; other extensions are ignored. All link files are collectively sorted and processed in lexical order, regardless of the directories in which they live. However, files with identical filenames replace each other. Files in /etc/ have the highest priority, files in /run/ take precedence over files with the same name in /lib/. This can be used to override a system-supplied link file with a local file if needed. As a special case, an empty file (file size 0) or symlink with the same name pointing to /dev/null disables the configuration file entirely (it is "masked").

Along with the link file foo.link, a "drop-in" directory foo.link.d/ may exist. All files with the suffix ".conf" from this directory will be merged in the alphanumeric order and parsed after the main file itself has been parsed. This is useful to alter or add configuration settings, without having to modify the main configuration file. Each drop-in file must have appropriate section headers.

In addition to /etc/systemd/network, drop-in ".d" directories can be placed in /lib/systemd/network or /run/systemd/network directories. Drop-in files in /etc/ take precedence over those in /run/ which in turn take precedence over those in /lib/. Drop-in files under any of these directories take precedence over the main link file wherever located.

The link file contains a [Match] section, which determines if a given link file may be applied to a given device, as well as a [Link] section specifying how the device should be configured. The first (in lexical order) of the link files that matches a given device is applied. Note that a default file 99-default.link is shipped by the system. Any user-supplied .link should hence have a lexically earlier name to be considered at all.

See udevadm(8) for diagnosing problems with .link files.

## [MATCH] SECTION OPTIONS
A link file is said to match a device if all matches specified by the [Match] section are satisfied. When a link file does not contain valid settings in [Match] section, then the file will match all devices and systemd-udevd warns about that. Hint: to avoid the warning and to make it clear that all interfaces shall be matched, add the following:

```
OriginalName=*
```

The following keys are accepted:

MACAddress=

A whitespace-separated list of hardware addresses. Use full colon-, hyphen- or dot-delimited hexadecimal. See the example below. This option may appear more than once, in which case the lists are merged. If the empty string is assigned to this option, the list of hardware addresses defined prior to this is reset. Example:

```
MACAddress=01:23:45:67:89:ab 00-11-22-33-44-55 AABB.CCDD.EEFF
```

PermanentMACAddress=

A whitespace-separated list of hardware's permanent addresses. While MACAddress= matches the device's current MAC address, this matches the device's permanent MAC address, which may be different from the current one. Use full colon-, hyphen- or dot-delimited hexadecimal. This option may appear more than once, in which case the lists are merged. If the empty string is assigned to this option, the list of hardware addresses defined prior to this is reset.

Path=

A whitespace-separated list of shell-style globs matching the persistent path, as exposed by the udev property ID_PATH.

Driver=

A whitespace-separated list of shell-style globs matching the driver currently bound to the device, as exposed by the udev property ID_NET_DRIVER of its parent device, or if that is not set, the driver as exposed by ethtool -i of the device itself. If the list is prefixed with a "!", the test is inverted.

Type=

A whitespace-separated list of shell-style globs matching the device type, as exposed by networkctl list. If the list is prefixed with a "!", the test is inverted. Some valid values are "ether", "loopback", "wlan", "wwan". Valid types are named either from the udev "DEVTYPE" attribute, or "ARPHRD_" macros in linux/if_arp.h, so this is not comprehensive.

Property=

A whitespace-separated list of udev property names with their values after equals sign ("="). If multiple properties are specified, the test results are ANDed. If the list is prefixed with a "!", the test is inverted. If a value contains white spaces, then please quote whole key and value pair. If a value contains quotation, then please escape the quotation with "\". Example: if a .link file has the following:

```
Property=ID_MODEL_ID=9999 "ID_VENDOR_FROM_DATABASE=vendor name" "KEY=with \"quotation\""
```

then, the .link file matches only when an interface has all the above three properties.

OriginalName=

A whitespace-separated list of shell-style globs matching the device name, as exposed by the udev property "INTERFACE". This cannot be used to match on names that have already been changed from userspace. Caution is advised when matching on kernel-assigned names, as they are known to be unstable between reboots.

Host=

Matches against the hostname or machine ID of the host. See ConditionHost= in systemd.unit(5) for details. When prefixed with an exclamation mark ("!"), the result is negated. If an empty string is assigned, then previously assigned value is cleared.

Virtualization=

Checks whether the system is executed in a virtualized environment and optionally test whether it is a specific implementation. See ConditionVirtualization= in systemd.unit(5) for details. When prefixed with an exclamation mark ("!"), the result is negated. If an empty string is assigned, then previously assigned value is cleared.

KernelCommandLine=

Checks whether a specific kernel command line option is set. See ConditionKernelCommandLine= in systemd.unit(5) for details. When prefixed with an exclamation mark ("!"), the result is negated. If an empty string is assigned, then previously assigned value is cleared.

KernelVersion=

Checks whether the kernel version (as reported by uname -r) matches a certain expression. See ConditionKernelVersion= in systemd.unit(5) for details. When prefixed with an exclamation mark ("!"), the result is negated. If an empty string is assigned, then previously assigned value is cleared.

Architecture=

Checks whether the system is running on a specific architecture. See ConditionArchitecture= in systemd.unit(5) for details. When prefixed with an exclamation mark ("!"), the result is negated. If an empty string is assigned, then previously assigned value is cleared.

Firmware=

Checks whether the system is running on a machine with the specified firmware. See ConditionFirmware= in systemd.unit(5) for details. When prefixed with an exclamation mark ("!"), the result is negated. If an empty string is assigned, then previously assigned value is cleared.

## [LINK] SECTION OPTIONS
The [Link] section accepts the following keys:

Description=

A description of the device.

Alias=

The ifalias interface property is set to this value.

MACAddressPolicy=

The policy by which the MAC address should be set. The available policies are: persistent

If the hardware has a persistent MAC address, as most hardware should, and if it is used by the kernel, nothing is done. Otherwise, a new MAC address is generated which is guaranteed to be the same on every boot for the given machine and the given device, but which is otherwise random. This feature depends on ID_NET_NAME_* properties to exist for the link. On hardware where these properties are not set, the generation of a persistent MAC address will fail.

random

If the kernel is using a random MAC address, nothing is done. Otherwise, a new address is randomly generated each time the device appears, typically at boot. Either way, the random address will have the "unicast" and "locally administered" bits set.

none

Keeps the MAC address assigned by the kernel. Or use the MAC address specified in MACAddress=.

An empty string assignment is equivalent to setting "none".

MACAddress=

The interface MAC address to use. For this setting to take effect, MACAddressPolicy= must either be unset, empty, or "none".

NamePolicy=

An ordered, space-separated list of policies by which the interface name should be set. NamePolicy= may be disabled by specifying net.ifnames=0 on the kernel command line. Each of the policies may fail, and the first successful one is used. The name is not set directly, but is exported to udev as the property ID_NET_NAME, which is, by default, used by a udev(7), rule to set NAME. The available policies are: kernel

If the kernel claims that the name it has set for a device is predictable, then no renaming is performed.

database

The name is set based on entries in the udev's Hardware Database with the key ID_NET_NAME_FROM_DATABASE.

onboard

The name is set based on information given by the firmware for on-board devices, as exported by the udev property ID_NET_NAME_ONBOARD. See systemd.net-naming-scheme(7).

slot

The name is set based on information given by the firmware for hot-plug devices, as exported by the udev property ID_NET_NAME_SLOT. See systemd.net-naming-scheme(7).

path

The name is set based on the device's physical location, as exported by the udev property ID_NET_NAME_PATH. See systemd.net-naming-scheme(7).

mac

The name is set based on the device's persistent MAC address, as exported by the udev property ID_NET_NAME_MAC. See systemd.net-naming-scheme(7).

keep

If the device already had a name given by userspace (as part of creation of the device or a rename), keep it.

Name=

The interface name to use. This option has lower precedence than NamePolicy=, so for this setting to take effect, NamePolicy= must either be unset, empty, disabled, or all policies configured there must fail. Also see the example below with "Name=dmz0". Note that specifying a name that the kernel might use for another interface (for example "eth0") is dangerous because the name assignment done by udev will race with the assignment done by the kernel, and only one interface may use the name. Depending on the order of operations, either udev or the kernel will win, making the naming unpredictable. It is best to use some different prefix, for example "internal0"/"external0" or "lan0"/"lan1"/"lan3".

AlternativeNamesPolicy=

A space-separated list of policies by which the interface's alternative names should be set. Each of the policies may fail, and all successful policies are used. The available policies are "database", "onboard", "slot", "path", and "mac". If the kernel does not support the alternative names, then this setting will be ignored.

AlternativeName=

The alternative interface name to use. This option can be specified multiple times. If the empty string is assigned to this option, the list is reset, and all prior assignments have no effect. If the kernel does not support the alternative names, then this setting will be ignored.

TransmitQueues=

Specifies the device's number of transmit queues. An integer in the range 1...4096. When unset, the kernel's default will be used.

ReceiveQueues=

Specifies the device's number of receive queues. An integer in the range 1...4096. When unset, the kernel's default will be used.

TransmitQueueLength=

Specifies the transmit queue length of the device in number of packets. An unsigned integer in the range 0...4294967294. When unset, the kernel's default will be used.

MTUBytes=

The maximum transmission unit in bytes to set for the device. The usual suffixes K, M, G are supported and are understood to the base of 1024.

BitsPerSecond=

The speed to set for the device, the value is rounded down to the nearest Mbps. The usual suffixes K, M, G are supported and are understood to the base of 1000.

Duplex=

The duplex mode to set for the device. The accepted values are half and full.

AutoNegotiation=

Takes a boolean. If set to yes, automatic negotiation of transmission parameters is enabled. Autonegotiation is a procedure by which two connected ethernet devices choose common transmission parameters, such as speed, duplex mode, and flow control. When unset, the kernel's default will be used. Note that if autonegotiation is enabled, speed and duplex settings are read-only. If autonegotiation is disabled, speed and duplex settings are writable if the driver supports multiple link modes.

WakeOnLan=

The Wake-on-LAN policy to set for the device. Takes the special value "off" which disables Wake-on-LAN, or space separated list of the following words: phy

Wake on PHY activity.

unicast

Wake on unicast messages.

multicast

Wake on multicast messages.

broadcast

Wake on broadcast messages.

arp

Wake on ARP.

magic

Wake on receipt of a magic packet.

secureon

Enable secureon(tm) password for MagicPacket(tm).

Defaults to unset, and the device's default will be used. This setting can be specified multiple times. If an empty string is assigned, then the all previous assignments are cleared.

Port=

The port option is used to select the device port. The supported values are: tp

An Ethernet interface using Twisted-Pair cable as the medium.

aui

Attachment Unit Interface (AUI). Normally used with hubs.

bnc

An Ethernet interface using BNC connectors and co-axial cable.

mii

An Ethernet interface using a Media Independent Interface (MII).

fibre

An Ethernet interface using Optical Fibre as the medium.

Advertise=

This sets what speeds and duplex modes of operation are advertised for auto-negotiation. This implies "AutoNegotiation=yes". The supported values are: Table 1. Supported advertise values

Advertise

Speed (Mbps)

Duplex Mode

10baset-half

10

half

10baset-full

10

full

100baset-half

100

half

100baset-full

100

full

1000baset-half

1000

half

1000baset-full

1000

full

10000baset-full

10000

full

2500basex-full

2500

full

1000basekx-full

1000

full

10000basekx4-full

10000

full

10000basekr-full

10000

full

10000baser-fec

10000

full

20000basemld2-full

20000

full

20000basekr2-full

20000

full

By default this is unset, i.e. all possible modes will be advertised. This option may be specified more than once, in which case all specified speeds and modes are advertised. If the empty string is assigned to this option, the list is reset, and all prior assignments have no effect.

ReceiveChecksumOffload=

Takes a boolean. If set to true, hardware offload for checksumming of ingress network packets is enabled. When unset, the kernel's default will be used.

TransmitChecksumOffload=

Takes a boolean. If set to true, hardware offload for checksumming of egress network packets is enabled. When unset, the kernel's default will be used.

TCPSegmentationOffload=

Takes a boolean. If set to true, TCP Segmentation Offload (TSO) is enabled. When unset, the kernel's default will be used.

TCP6SegmentationOffload=

Takes a boolean. If set to true, TCP6 Segmentation Offload (tx-tcp6-segmentation) is enabled. When unset, the kernel's default will be used.

GenericSegmentationOffload=

Takes a boolean. If set to true, Generic Segmentation Offload (GSO) is enabled. When unset, the kernel's default will be used.

GenericReceiveOffload=

Takes a boolean. If set to true, Generic Receive Offload (GRO) is enabled. When unset, the kernel's default will be used.

LargeReceiveOffload=

Takes a boolean. If set to true, Large Receive Offload (LRO) is enabled. When unset, the kernel's default will be used.

RxChannels=

Sets the number of receive channels (a number between 1 and 4294967295) .

TxChannels=

Sets the number of transmit channels (a number between 1 and 4294967295).

OtherChannels=

Sets the number of other channels (a number between 1 and 4294967295).

CombinedChannels=

Sets the number of combined set channels (a number between 1 and 4294967295).

RxBufferSize=

Takes an integer. Specifies the maximum number of pending packets in the NIC receive buffer. When unset, the kernel's default will be used.

RxMiniBufferSize=

Takes an integer. Specifies the maximum number of pending packets in the NIC mini receive buffer. When unset, the kernel's default will be used.

RxJumboBufferSize=

Takes an integer. Specifies the maximum number of pending packets in the NIC jumbo receive buffer. When unset, the kernel's default will be used.

TxBufferSize=

Takes an integer. Specifies the maximum number of pending packets in the NIC transmit buffer. When unset, the kernel's default will be used.

RxFlowControl=

Takes a boolean. When set, enables receive flow control, also known as the ethernet receive PAUSE message (generate and send ethernet PAUSE frames). When unset, the kernel's default will be used.

TxFlowControl=

Takes a boolean. When set, enables transmit flow control, also known as the ethernet transmit PAUSE message (respond to received ethernet PAUSE frames). When unset, the kernel's default will be used.

AutoNegotiationFlowControl=

Takes a boolean. When set, auto negotiation enables the interface to exchange state advertisements with the connected peer so that the two devices can agree on the ethernet PAUSE configuration. When unset, the kernel's default will be used.

GenericSegmentOffloadMaxBytes=

Specifies the maximum size of a Generic Segment Offload (GSO) packet the device should accept. The usual suffixes K, M, G are supported and are understood to the base of 1024. An unsigned integer in the range 1...65536. Defaults to unset.

GenericSegmentOffloadMaxSegments=

Specifies the maximum number of Generic Segment Offload (GSO) segments the device should accept. An unsigned integer in the range 1...65535. Defaults to unset.

## EXAMPLES
Example 1. /lib/systemd/network/99-default.link

The link file 99-default.link that is shipped with systemd defines the default naming policy for links.

```
[Link]
NamePolicy=kernel database onboard slot path
MACAddressPolicy=persistent
```

Example 2. /etc/systemd/network/10-dmz.link

This example assigns the fixed name "dmz0" to the interface with the MAC address 00:a0:de:63:7a:e6:

```
[Match]
MACAddress=00:a0:de:63:7a:e6
[Link]
Name=dmz0
```

NamePolicy= is not set, so Name= takes effect. We use the "10-" prefix to order this file early in the list. Note that it needs to be before "99-link", i.e. it needs a numerical prefix, to have any effect at all.

Example 3. Debugging NamePolicy= assignments

```
$ sudo SYSTEMD_LOG_LEVEL=debug udevadm test-builtin net_setup_link /sys/class/net/hub0
...
Parsed configuration file /lib/systemd/network/99-default.link
Parsed configuration file /etc/systemd/network/10-eth0.link
ID_NET_DRIVER=cdc_ether
Config file /etc/systemd/network/10-eth0.link applies to device hub0
link_config: autonegotiation is unset or enabled, the speed and duplex are not writable.
hub0: Device has name_assign_type=4
Using default interface naming scheme 'v240'.
hub0: Policies didn't yield a name, using specified Name=hub0.
ID_NET_LINK_FILE=/etc/systemd/network/10-eth0.link
ID_NET_NAME=hub0
...
```

Explicit Name= configuration wins in this case.

```
sudo SYSTEMD_LOG_LEVEL=debug udevadm test-builtin net_setup_link /sys/class/net/enp0s31f6
...
Parsed configuration file /lib/systemd/network/99-default.link
Parsed configuration file /etc/systemd/network/10-eth0.link
Created link configuration context.
ID_NET_DRIVER=e1000e
Config file /lib/systemd/network/99-default.link applies to device enp0s31f6
link_config: autonegotiation is unset or enabled, the speed and duplex are not writable.
enp0s31f6: Device has name_assign_type=4
Using default interface naming scheme 'v240'.
enp0s31f6: Policy *keep*: keeping existing userspace name
enp0s31f6: Device has addr_assign_type=0
enp0s31f6: MAC on the device already matches policy *persistent*
ID_NET_LINK_FILE=/lib/systemd/network/99-default.link
...
```

In this case, the interface was already renamed, so the keep policy specified as the first option in 99-default.link means that the existing name is preserved. If keep was removed, or if were in boot before the renaming has happened, we might get the following instead:

```
enp0s31f6: Policy *path* yields "enp0s31f6".
enp0s31f6: Device has addr_assign_type=0
enp0s31f6: MAC on the device already matches policy *persistent*
ID_NET_LINK_FILE=/lib/systemd/network/99-default.link
ID_NET_NAME=enp0s31f6
...
```

Please note that the details of output are subject to change.

Example 4. /etc/systemd/network/10-internet.link

This example assigns the fixed name "internet0" to the interface with the device path "pci-0000:00:1a.0-*":

```
[Match]
Path=pci-0000:00:1a.0-*
[Link]
Name=internet0
```

Example 5. /etc/systemd/network/25-wireless.link

Here's an overly complex example that shows the use of a large number of [Match] and [Link] settings.

```
[Match]
MACAddress=12:34:56:78:9a:bc
Driver=brcmsmac
Path=pci-0000:02:00.0-*
Type=wlan
Virtualization=no
Host=my-laptop
Architecture=x86-64
[Link]
Name=wireless0
MTUBytes=1450
BitsPerSecond=10M
WakeOnLan=magic
MACAddress=cb:a9:87:65:43:21
```

## SEE ALSO
systemd-udevd.service(8), udevadm(8), systemd.netdev(5), systemd.network(5)


udev.conf

title: udev.conf(5)

text:
# udev.conf(5)

## NAME
udev.conf - Configuration for device event managing daemon

## SYNOPSIS
/etc/udev/udev.conf

## DESCRIPTION
systemd-udevd(8) expects its main configuration file at /etc/udev/udev.conf. It consists of a set of variables allowing the user to override default udev values. All empty lines or lines beginning with '#' are ignored. The following variables can be set:

udev_log=

The log level. Valid values are the numerical syslog priorities or their textual representations: err, info and debug.

children_max=

An integer. The maximum number of events executed in parallel. This is the same as the --children-max= option.

exec_delay=

An integer. Delay the execution of each RUN{program} parameter by the given number of seconds. This option might be useful when debugging system crashes during coldplug caused by loading non-working kernel modules. This is the same as the --exec-delay= option.

event_timeout=

An integer. The number of seconds to wait for events to finish. After this time, the event will be terminated. The default is 180 seconds. This is the same as the --event-timeout= option.

resolve_names=

Specifies when systemd-udevd should resolve names of users and groups. When set to early (the default), names will be resolved when the rules are parsed. When set to late, names will be resolved for every event. When set to never, names will never be resolved and all devices will be owned by root. This is the same as the --resolve-names= option.

timeout_signal=

Specifies a signal that systemd-udevd will send on worker timeouts. Note that both workers and spawned processes will be killed using this signal. Defaults to SIGKILL.

In addition, systemd-udevd can be configured by command line options and the kernel command line (see systemd-udevd(8)).

## SEE ALSO
systemd-udevd(8), udev(7), udevadm(8)


title: udisks2.conf(5)

summary: The udisks2 configuration file

text:
# udisks2.conf(5)

## NAME
udisks2.conf - The udisks2 configuration file

## DESCRIPTION
The udisks project provides additional functionality via pluggable modules. These plugins can be inserted into the daemon either by D-Bus call org.freedesktop.UDisks2.Manager.EnableModules() or by running the udisks daemon with --force-load-modules command line option.

It is also possible to configure the modules loading behavior via the configuration file placed at /etc/udisks2/udisks2.conf.

## CONFIGURATION FILE
The default configuration file udisks2.conf looks like this:

```
    [udisks2]

    modules=*

    modules_load_preference=ondemand

    [defaults]

    encryption=luks1

```

modules = <string list>

This variable controls what modules should be loaded. It may contain either a comma-separated list of modules to load or a single asterisk which stands for all the modules.

modules_load_preference = ondemand|onstartup

This key tells udisksd when to load the plugins: either at startup or on demand by D-Bus org.freedesktop.UDisks2.Manager.EnableModules().

encryption = luks1|luks2

This variable controls which encryption technology will be used by default when creating an encrypted filesystem.

## AUTHOR
<phatina@redhat.com>

## BUGS
Please send bug reports to either the distribution bug tracker or the upstream bug tracker at https://github.com/storaged-project/udisks/issues.

## SEE ALSO
udisks(8), udisksctl(1), umount.udisks2(8)