Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

lurename(1m) [linux man page]

lurename(1M)						  System Administration Commands					      lurename(1M)

NAME

       lurename - change the name of a boot environment

SYNOPSIS

       /usr/sbin/lurename -e BE_name -n new_name [-l error_log] [-o outfile] [-X]

DESCRIPTION

       The  lurename  command  is  part  of  a	suite  of commands that make up the Live Upgrade feature of the Solaris operating environment. See
       live_upgrade(5) for a description of the Live Upgrade feature.

       The lurename command renames the boot environment (BE) BE_name to new_name.

       The string new_name must not exceed 30 characters in length and must consist only of alphanumeric characters  and  other  ASCII	characters
       that  are not special to the Unix shell. See the "Quoting" section of sh(1). The BE name can contain only single-byte, 8-bit characters. It
       cannot contain whitespace characters. Also, new_name must be unique on the system.

       A BE must have the status "complete" before you rename it. Use lustatus(1M) to determine a BE's status. Also, you cannot rename a  BE  that
       has file systems mounted with lumount(1M) or mount(1M).

       Renaming  a  BE	is  often  useful  when you upgrade the BE from one Solaris release to another. For example, following an operating system
       upgrade, you might rename the BE solaris7 to solaris8.

       The lurename command requires root privileges.

OPTIONS

       The lurename command has the options listed below.

       -e BE_name	       Name of the BE whose name you want to change.

       -l error_log	       Error and status messages are sent to error_log, in addition to where they are sent in your current environment.

       -n new_name	       New name of the BE. new_name must be unique on a given system.

       -o outfile	       All command output is sent to outfile, in addition to where it is sent in your current environment.

       -X		       Enable XML output. Characteristics of XML are defined in  DTD,  in  /usr/share/lib/xml/dtd/lu_cli.dtd.<num>,  where
			       <num> is the version number of the DTD file.

EXIT STATUS

       The following exit values are returned:

       0	Successful completion.

       >0	An error occurred.

FILES

       /etc/lutab

	   list of BEs on the system

       /usr/share/lib/xml/dtd/lu_cli.dtd.<num>

	   Live Upgrade DTD (see -X option)

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWluu			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       lu(1M),	luactivate(1M),  lucancel(1M),	lucompare(1M),	lucreate(1M),  lucurr(1M),  ludelete(1M),  ludesc(1M),	lufslist(1M),  lumake(1M),
       lumount(1M), lustatus(1M), luupgrade(1M), lutab(4), attributes(5), live_upgrade(5)

SunOS 5.10							    24 Jan 2002 						      lurename(1M)

Check Out this Related Man Page

lucurr(1M)																lucurr(1M)

NAME

       lucurr - display the name of the active boot environment

SYNOPSIS

       /usr/sbin/lucurr [-l error_log] [-m mount_point] [-o outfile] [-X]

DESCRIPTION

       The  lucurr  command  is  part  of  a  suite  of  commands  that make up the Live Upgrade feature of the Solaris operating environment. See
       live_upgrade(5) for a description of the Live Upgrade feature.

       The lucurr command displays the name of the currently running boot environment (BE). If no BEs are configured on the  system,  lucurr  dis-
       plays  the  message  "No  Boot Environments are defined". Note that lucurr reports only the name of the current BE, not the BE that will be
       active upon the next reboot. Use lustatus(1M) or luactivate(1M) for this information.

       The lucurr command requires root privileges.

OPTIONS

       The lucurr command has the following options:

       -l error_log

	   Error and status messages are sent to error_log, in addition to where they are sent in your current environment.

       -m mount_point

	   Returns the name of the BE that owns mount_point, where mount_point is the mount point of a BE's root file system. This can be a  mount
	   point  of  the current BE or the mount point of a BE other than the current BE. If the latter, the file system of the BE must have been
	   mounted with lumount(1M) or mount(1M) before entering this option.

       -o outfile

	   All command output is sent to outfile, in addition to where it is sent in your current environment.

       -X

	   Enable XML output. Characteristics of XML are defined in DTD, in /usr/share/lib/xml/dtd/lu_cli.dtd.<num>, where <num>  is  the  version
	   number of the DTD file.

EXIT STATUS

       The following exit values are returned:

       0	Successful completion.

       >0	An error occurred.

FILES

       /etc/lutab

	   list of BEs on the system

       /usr/share/lib/xml/dtd/lu_cli.dtd.<num>

	   Live Upgrade DTD (see -X option)

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWluu			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       lu(1M),	luactivate(1M),  lucancel(1M), lucompare(1M), lucreate(1M), ludelete(1M), ludesc(1M), lufslist(1M), lumake(1M), lumount(1M), lure-
       name(1M), lustatus(1M), luupgrade(1M), lutab(4), attributes(5), live_upgrade(5)

SunOS 5.10							    24 Jan 2002 							lucurr(1M)
Man Page