1# Copyright (C) 2009 Red Hat, Inc. All rights reserved. 2# 3# This file is part of LVM2. 4 5# Udev rules for device-mapper devices. 6# 7# These rules create a DM control node in /dev/(DM_DIR) directory. 8# The rules also create nodes named dm-x (x is a number) in /dev 9# directory and symlinks to these nodes with names given by 10# the actual DM names. Some udev environment variables are set 11# for use in later rules: 12# DM_NAME - actual DM device's name 13# DM_UUID - UUID set for DM device (blank if not specified) 14# DM_SUSPENDED - suspended state of DM device (0 or 1) 15# DM_UDEV_RULES_VSN - DM udev rules version 16 17KERNEL=="device-mapper", NAME="(DM_DIR)/control" 18 19SUBSYSTEM!="block", GOTO="dm_end" 20KERNEL!="dm-[0-9]*", GOTO="dm_end" 21 22# Set proper sbin path, /sbin has higher priority than /usr/sbin. 23ENV{DM_SBIN_PATH}="/sbin" 24TEST!="$env{DM_SBIN_PATH}/dmsetup", ENV{DM_SBIN_PATH}="/usr/sbin" 25TEST!="$env{DM_SBIN_PATH}/dmsetup", GOTO="dm_end" 26 27# Decode udev control flags and set environment variables appropriately. 28# These flags are encoded in DM_COOKIE variable that was introduced in 29# kernel version 2.6.31. Therefore, we can use this feature with 30# kernels >= 2.6.31 only. 31ENV{DM_COOKIE}=="?*", IMPORT{program}="$env{DM_SBIN_PATH}/dmsetup udevflags $env{DM_COOKIE}" 32 33# Normally, we would test for DM_UDEV_DISABLE_DM_RULES_FLAG here and skip 34# the rules if set. However, we need to set DM_* environment variables 35# for now to properly filter out inappropriate events. This dependency 36# might be removed in the future. 37 38ACTION!="add|change", GOTO="dm_end" 39 40# Normally, we operate on "change" events only. But when 41# coldplugging, there's an "add" event present. We have to 42# recognize this and do our actions in this particular 43# situation, too. Also, we don't want the nodes to be 44# created prematurely on "add" events while not coldplugging. 45ACTION=="add", ENV{STARTUP}!="1", NAME="", GOTO="dm_end" 46 47# "dm" sysfs subdirectory is available in newer versions of DM 48# only (kernels >= 2.6.29). We have to check for its existence 49# and use dmsetup tool instead to get the DM name, uuid and 50# suspended state if the "dm" subdirectory is not present. 51# The "suspended" item was added even later (kernels >= 2.6.31), 52# so we also have to call dmsetup if the kernel version used 53# is in between these releases. 54TEST=="dm", ENV{DM_NAME}="$attr{dm/name}", ENV{DM_UUID}="$attr{dm/uuid}", ENV{DM_SUSPENDED}="$attr{dm/suspended}" 55TEST!="dm", IMPORT{program}="$env{DM_SBIN_PATH}/dmsetup info -j %M -m %m -c --nameprefixes --noheadings --rows -o name,uuid,suspended" 56ENV{DM_SUSPENDED}!="?*", IMPORT{program}="$env{DM_SBIN_PATH}/dmsetup info -j %M -m %m -c --nameprefixes --noheadings --rows -o suspended" 57 58# dmsetup tool provides suspended state information in textual 59# form with values "Suspended"/"Active". We translate it to 60# 0/1 respectively to be consistent with sysfs values. 61ENV{DM_SUSPENDED}=="Active", ENV{DM_SUSPENDED}="0" 62ENV{DM_SUSPENDED}=="Suspended", ENV{DM_SUSPENDED}="1" 63 64# This variable provides a reliable way to check that device-mapper 65# rules were installed. It means that all needed variables are set 66# by these rules directly so there's no need to acquire them again 67# later. Other rules can alternate the functionality based on this 68# fact (e.g. fallback to rules that behave correctly even without 69# these rules installed). It also provides versioning for any 70# possible future changes. 71ENV{DM_UDEV_RULES_VSN}="1" 72 73ENV{DM_UDEV_DISABLE_DM_RULES_FLAG}!="1", ENV{DM_NAME}=="?*", SYMLINK+="(DM_DIR)/$env{DM_NAME}" 74 75# We have to ignore further rule application for inappropriate events 76# and devices. But still send the notification if cookie exists. 77ENV{DM_UUID}=="mpath-?*", ENV{DM_ACTION}=="PATH_FAILED", GOTO="dm_disable" 78ENV{DM_UUID}=="CRYPT-TEMP-?*", GOTO="dm_disable" 79ENV{DM_UUID}!="?*", ENV{DM_NAME}=="temporary-cryptsetup-?*", GOTO="dm_disable" 80 81GOTO="dm_end" 82 83LABEL="dm_disable" 84ENV{DM_UDEV_DISABLE_SUBSYSTEM_RULES_FLAG}="1" 85ENV{DM_UDEV_DISABLE_DISK_RULES_FLAG}="1" 86ENV{DM_UDEV_DISABLE_OTHER_RULES_FLAG}="1" 87 88LABEL="dm_end" 89