~ubuntu-branches/debian/sid/lvm2/sid

« back to all changes in this revision

Viewing changes to man/lvchange.8.in

• browse files at revision 41
• compare with another revision
• download diff
• download tarball
• view history from revision 41

Show diffs side-by-side

added

removed

man/lvchange.8.in

1

1

.TH LVCHANGE 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-

2

2

.SH NAME

3

 

lvchange \- change attributes of a logical volume

 

3

lvchange \(em change attributes of a logical volume

4

4

.SH SYNOPSIS

5

5

.B lvchange

6

6

.RB [ \-\-addtag

9

9

.RI { y | n }]

10

10

.RB [ \-a | \-\-activate

11

11

.RI [ a | e | l ]{ y | n }]

 

12

.RB [ \-\-activationmode

 

13

.IR { complete | degraded | partial } ]

12

14

.RB [ \-k | \-\-setactivationskip { y | n } ]

13

15

.RB [ \-K | \-\-ignoreactivationskip ]

14

16

.RB [ \-\-alloc

15

17

.IR AllocationPolicy ]

 

18

.RB [ \-\-commandprofile

 

19

.IR ProfileName ]

16

20

.RB [ \-C | \-\-contiguous

17

21

.RI { y | n }]

18

22

.RB [ \-d | \-\-debug ]

 

23

.RB [ \-\-degraded ]

19

24

.RB [ \-\-deltag

20

25

.IR Tag ]

21

 

.RB [ \-\-profile

22

 

.IR ProfileName ]

23

26

.RB [ \-\-detachprofile ]

24

27

.RB [ \-\-discards

25

28

.RI { ignore | nopassdown | passdown }]

44

47

.IR PhysicalVolume [ : { t | n | y }]]

45

48

.RB [ \-\-sysinit ]

46

49

.RB [ \-\-noudevsync ]

 

50

.RB [ \-\-metadataprofile

 

51

.IR ProfileName ]

47

52

.RB [ \-M | \-\-persistent

48

53

.RI { y | n }]

49

54

.RB [ \-\-minor

70

75

Controls the availability of the logical volumes for use.

71

76

Communicates with the kernel device-mapper driver via

72

77

libdevmapper to activate (\-ay) or deactivate (\-an) the

73

 

logical volumes. If autoactivation option is used (\-aay),

 

78

logical volumes. 

 

79

.IP

 

80

Activation of a logical volume creates a symbolic link

 

81

/dev/VolumeGroupName/LogicalVolumeName pointing to the device node.

 

82

This link is removed on deactivation.

 

83

All software and scripts should access the device through

 

84

this symbolic link and present this as the name of the device.

 

85

The location and name of the underlying device node may depend on 

 

86

the distribution and configuration (e.g. udev) and might change 

 

87

from release to release.

 

88

.IP

 

89

If autoactivation option is used (\-aay),

74

90

the logical volume is activated only if it matches an item in

75

91

the activation/auto_activation_volume_list set in lvm.conf.

76

92

If this list is not set, then all volumes are considered for

84

100

Logical volumes with single-host snapshots are always activated

85

101

exclusively because they can only be used on one node at once.

86

102

.TP

 

103

.BR \-\-activationmode " {" \fIcomplete | \fIdegraded | \fIpartial }

 

104

The activation mode determines whether logical volumes are allowed to

 

105

activate when there are physical volumes missing (e.g. due to a device

 

106

failure).  \fIcomplete is the most restrictive; allowing only those

 

107

logical volumes to be activated that are not affected by the missing

 

108

PVs.  \fIdegraded allows RAID logical volumes to be activated even if

 

109

they have PVs missing.  (Note that the "mirror" segment type is not

 

110

considered a RAID logical volume.  The "raid1" segment type should

 

111

be used instead.)  Finally, \fIpartial allows any logical volume to

 

112

be activated even if portions are missing due to a missing or failed

 

113

PV.  This last option should only be used when performing recovery or

 

114

repair operations.  \fIdegraded is the default mode.  To change it, modify

 

115

.B activation_mode

 

116

in

 

117

.BR lvm.conf (5).

 

118

.TP

87

119

.BR \-k ", " \-\-setactivationskip " {" \fIy | \fIn }

88

120

Controls  whether Logical Volumes are persistently flagged to be

89

121

skipped during activation. By default, thin snapshot volumes are

103

135

allocated physical extents are already contiguous.

104

136

.TP

105

137

.BR \-\-detachprofile

106

 

Detach any configuration profiles attached to given Logical Volumes.

107

 

See also \fBlvm\fP(8) and \fBlvm.conf\fP(5) for more

108

 

information about configuration profiles.

 

138

Detach any metadata configuration profiles attached to given

 

139

Logical Volumes. See \fBlvm.conf\fP(5) for more information

 

140

about \fBmetadata profiles\fP.

109

141

.TP

110

142

.BR \-\-discards " {" \fIignore | \fInopassdown | \fIpassdown }

111

143

Set this to \fIignore\fP to ignore any discards received by a

123

155

time - and during this time you are without a complete redundant copy

124

156

of your data.

125

157

.TP

 

158

.B \-\-metadataprofile " " \fIProfileName

 

159

Uses and attaches ProfileName configuration profile to the logical

 

160

volume metadata. Whenever the logical volume is processed next time,

 

161

the profile is automatically applied. If the volume group has another

 

162

profile attached, the logical volume profile is preferred.

 

163

See \fBlvm.conf\fP(5) for more information about \fBmetadata profiles\fP.

 

164

.TP

126

165

.B \-\-minor \fIminor

127

166

Set the minor number.

128

167

.TP

145

184

.IR \fB\-\-[raid]maxrecoveryrate " " \fIRate [ bBsSkKmMgG ]

146

185

Sets the maximum recovery rate for a RAID logical volume.  \fIRate\fP

147

186

is specified as an amount per second for each device in the array.

148

 

If no suffix is given, then kiB/sec/device is assumed.  Setting the

 

187

If no suffix is given, then KiB/sec/device is assumed.  Setting the

149

188

recovery rate to 0 means it will be unbounded.

150

189

.TP

151

190

.IR \fB\-\-[raid]minrecoveryrate " " \fIRate [ bBsSkKmMgG ]

152

191

Sets the minimum recovery rate for a RAID logical volume.  \fIRate\fP

153

192

is specified as an amount per second for each device in the array.

154

 

If no suffix is given, then kiB/sec/device is assumed.  Setting the

 

193

If no suffix is given, then KiB/sec/device is assumed.  Setting the

155

194

recovery rate to 0 means it will be unbounded.

156

195

.TP

157

196

.BR \-\-[raid]syncaction " {" \fIcheck | \fIrepair }

181

220

set the write-mostly attribute for the specified physical volume in the

182

221

logical volume.  It is possible to also remove the write-mostly flag by

183

222

appending a ":n" to the physical volume or to toggle the value by specifying

184

 

":t".  The \fI--writemostly\fP argument can be specified more than one time

 

223

":t".  The \fB\-\-writemostly\fP argument can be specified more than one time

185

224

in a single command; making it possible to toggle the write-mostly attributes

186

225

for all the physical volumes in a logical volume at once.

187

226

.TP

237

276

Set zeroing mode for thin pool. Note: already provisioned blocks from pool

238

277

in non-zero mode are not cleared in unwritten parts when setting zero to

239

278

\fIy\fP.

 

279

.SH ENVIRONMENT VARIABLES

 

280

.TP

 

281

.B LVM_SUPPRESS_LOCKING_FAILURE_MESSAGES

 

282

Suppress locking failure messages.

240

283

.SH Examples

241

284

Changes the permission on volume lvol1 in volume group vg00 to be read-only:

242

285

.sp

243

 

.B lvchange -pr vg00/lvol1

 

286

.B lvchange \-pr vg00/lvol1

244

287

.SH SEE ALSO

245

288

.BR lvm (8),

 

289

.BR lvmcache (7),

 

290

.BR lvmthin (7),

246

291

.BR lvcreate (8),

247

292

.BR vgchange (8)

• Older »

Loggerhead is a web-based interface for Breezy
Version: 2.0.1