synclvodm Command

Purpose

Rebuilds the logical volume control block, the device configuration database, and the device special files.

Syntax

synclvodm [ -c | -D | -F | -k | -K | -P | -R | -v ] VolumeGroup LogicalVolume ...

Description

The synclvodm command rebuilds the logical volume control block, the device configuration database, and the device special files (for the volume group and logical volumes), so that they are synchronized with the volume group descriptor areas on the physical volumes.

During normal operations, the device configuration database remains consistent with the logical volume manager information in the logical volume control blocks and the volume group descriptor areas on the physical volumes. If for some reason the device configuration database is not consistent with Logical Volume Manager information, the synclvodm command can be used to resynchronize the database. The volume group must be active for the resynchronization to occur (see varyonvg). If logical volume names are specified, only the information related to those logical volumes is updated. If logical volume names are not specified, every logical volume in the volume group is updated.

Attention: Do not remove the /dev entries for volume groups or logical volumes. Do not change the device configuration database entries for volume groups or logical volumes using the object data manager.
Note: To use this command, you must either have root user authority or be a member of the system group.

Flags

Item Description
-c Treats naming conflicts as fatal errors. If this flag is not specified, the command generates a warning message for any naming conflicts, and automatically renames the logical volume by default.

A logical volume naming conflict occurs when the logical volume name is already in use by another device. A volume group naming conflict occurs when the volume group major number cannot be reserved in the device configuration database.

-D Does not remove or recreate the logical volume minor numbers and device special files. If not specified, the command removes and recreates the logical volume minor numbers and device special files by default.
-F Does not synchronize the device configuration database entries for the physical volumes in the volume group. If this flag is not specified, the command removes the device configuration database entries for all physical volumes in the volume group, and recreates those entries based on the information in the volume group descriptor area by default.
-k Takes the volume group lock when the synclvodm command is running. If this flag is not specified, the volume group lock is taken only if the parent process does not have the lock.
-K Does not take the volume group lock when the synclvodm command is running. Use this flag when the caller is a shell script, and is managing the volume group lock in the shell script with the putlvodm -k and -K flags. The default behavior is to take the volume group lock unless the parent process has the lock.
-P Preserves the permission bits for the special files of logical volume device. The -P flag overrides the -D flag. The -P flag is ignored for original type volume groups. If this flag is not set, the ownership of the logical volume special file is set to root, and the group is set to system.
-R Restores the user, group, and permissions for the logical volume device special files to the values previously set by the mklv and chlv commands using the -U, -G, and -P flags. The -R flag is ignored for original type volume groups, or when the -D flag is specified.
-v Displays the output from the synclvodm command in verbose mode.

Security

Attention RBAC users and Trusted AIX users: This command can perform privileged operations. Only privileged users can run privileged operations. For more information about authorizations and privileges, see Privileged Command Database in AIX® Version 7.1 Security. For a list of privileges and the authorizations associated with this command, see the lssecattr command or the getcmdattr subcommand.

Examples

To synchronize the device configuration database with the logical volume manager information for rootvg, enter the following:

synclvodm rootvg

Files

Item Description
/usr/sbin/synclvodm Contains the synclvodm command.