Differential D13335 Diff 36329 sbin/camcontrol/camcontrol.8

Changeset View

Standalone View

sbin/camcontrol/camcontrol.8

	Show First 20 Lines • Show All 1,452 Lines • ▼ Show 20 Lines
	command.			command.
	The security level determines device behavior when the master			The security level determines device behavior when the master
	password is used to unlock the device.			password is used to unlock the device.
	When the security level is set to high			When the security level is set to high
	the device requires the unlock command and the master password to unlock.			the device requires the unlock command and the master password to unlock.
	When the security level is set to maximum the device requires a secure erase			When the security level is set to maximum the device requires a secure erase
	with the master password to unlock.			with the master password to unlock.
	.Pp			.Pp
	This option must be used in conjunction with one of the security action commands.			This option must be used in conjunction with one of the security action
				commands.
	.Pp			.Pp
	Defaults to			Defaults to
	.Em high			.Em high
	.It Fl q			.It Fl q
	.Pp			.Pp
	Be quiet, do not print any status messages.			Be quiet, do not print any status messages.
	This option will not disable the questions, however.			This option will not disable the questions, however.
	To disable questions, use the			To disable questions, use the
	.Fl y			.Fl y
	argument, below.			argument, below.
	.It Fl s Ar pwd			.It Fl s Ar pwd
	.Pp			.Pp
	Password the device (enable security) using the given password for the selected			Password the device (enable security) using the given password for the selected
	user.			user.
	This option can be combined with other options such as			This option can be combined with other options such as
	.Fl e Em pwd			.Fl e Em pwd
	.Pp			.Pp
	A master password may be set in a addition to the user password. The purpose of			A master password may be set in a addition to the user password.
	the master password is to allow an administrator to establish a password that			The purpose of the master password is to allow an administrator to establish a
	is kept secret from the user, and which may be used to unlock the device if the			password that is kept secret from the user, and which may be used to unlock the
	user password is lost.			device if the user password is lost.
	.Pp			.Pp
	.Em Note:			.Em Note:
	Setting the master password does not enable device security.			Setting the master password does not enable device security.
	.Pp			.Pp
	If the master password is set and the drive supports a Master Revision Code			If the master password is set and the drive supports a Master Revision Code
	feature the Master Password Revision Code will be decremented.			feature the Master Password Revision Code will be decremented.
	.It Fl T Ar timeout			.It Fl T Ar timeout
	.Pp			.Pp
	▲ Show 20 Lines • Show All 711 Lines • ▼ Show 20 Lines
	They may be written randomly.			They may be written randomly.
	Writes that do not conform to the zone layout may be significantly slower			Writes that do not conform to the zone layout may be significantly slower
	than expected.			than expected.
	.It Sequential Required			.It Sequential Required
	These zones must be written sequentially.			These zones must be written sequentially.
	If they are not written sequentially, starting at the write pointer, the			If they are not written sequentially, starting at the write pointer, the
	command will fail.			command will fail.
	.El			.El
	.Pp
	.Bl -tag -width 12n			.Bl -tag -width 12n
	.It Fl c Ar cmd			.It Fl c Ar cmd
	Specify the zone subcommand:			Specify the zone subcommand:
	.Bl -tag -width 6n			.Bl -tag -width 6n
	.It rz			.It rz
	Issue the Report Zones command.			Issue the Report Zones command.
	All zones are returned by default.			All zones are returned by default.
	Specify report options with			Specify report options with
	▲ Show 20 Lines • Show All 235 Lines • ▼ Show 20 Lines
	This shows the list of Idle and Standby power conditions the drive			This shows the list of Idle and Standby power conditions the drive
	supports, and a number of parameters about each condition, including			supports, and a number of parameters about each condition, including
	whether it is enabled and what the timer value is.			whether it is enabled and what the timer value is.
	.El			.El
	.El			.El
	.It Ic timestamp			.It Ic timestamp
	Issue REPORT TIMESTAMP or SET TIMESTAMP			Issue REPORT TIMESTAMP or SET TIMESTAMP
	.Tn SCSI			.Tn SCSI
	commands. Either the			commands.
				Either the
	.Fl r			.Fl r
	option or the			option or the
	.Fl s			.Fl s
	option must be specified.			option must be specified.
	.Bl -tag -width 6n			.Bl -tag -width 6n
	.It Fl r			.It Fl r
	Report the device's timestamp.			Report the device's timestamp.
	If no more arguments are specified, the timestamp will be reported using			If no more arguments are specified, the timestamp will be reported using
	the national representation of the date and time, followed by the time			the national representation of the date and time, followed by the time
	zone.			zone.
	.Bl -tag -width 9n			.Bl -tag -width 9n
	.It Fl f Ar format			.It Fl f Ar format
	Specify the strftime format string, as documented in strftime(3), to be used			Specify the strftime format string, as documented in strftime(3), to be used
	to format the reported timestamp.			to format the reported timestamp.
	.It Fl m			.It Fl m
	Report the timestamp as milliseconds since the epoch.			Report the timestamp as milliseconds since the epoch.
	.It Fl U			.It Fl U
	Report the timestamp using the national representation of the date and			Report the timestamp using the national representation of the date and
	time, but override the system time zone and use UTC instead.			time, but override the system time zone and use UTC instead.
	.El			.El
	.El			.El
	.Bl -tag -width 6n			.Bl -tag -width 6n
	.It Fl s			.It Fl s
	Set the device's timestamp. Either the			Set the device's timestamp.
				Either the
	.Fl f			.Fl f
	and			and
	.Fl T			.Fl T
	options or the			options or the
	.Fl U			.Fl U
	option must be specified.			option must be specified.
	.Bl -tag -width 9n			.Bl -tag -width 9n
	.It Fl f Ar format			.It Fl f Ar format
	Specify the strptime format string, as documented in strptime(3).			Specify the strptime format string, as documented in strptime(3).
	The time must also be specified with the			The time must also be specified with the
	▲ Show 20 Lines • Show All 238 Lines • ▼ Show 20 Lines
	.Bd -literal -offset indent			.Bd -literal -offset indent
	camcontrol attrib sa0 -v -i attr_values -p 1			camcontrol attrib sa0 -v -i attr_values -p 1
	.Ed			.Ed
	.Pp			.Pp
	This will read and decode the attribute values from partition 1 on the tape			This will read and decode the attribute values from partition 1 on the tape
	in tape drive sa0, and will display any			in tape drive sa0, and will display any
	.Tn SCSI			.Tn SCSI
	errors that result.			errors that result.
	.Pp
	.Bd -literal -offset indent			.Bd -literal -offset indent
	camcontrol zone da0 -v -c rz -P summary			camcontrol zone da0 -v -c rz -P summary
	.Ed			.Ed
	.Pp			.Pp
	This will request the SMR zone list from disk da0, and print out a			This will request the SMR zone list from disk da0, and print out a
	summary of the zone parameters, and display any			summary of the zone parameters, and display any
	.Tn SCSI			.Tn SCSI
	or			or
	.Tn ATA			.Tn ATA
	errors that result.			errors that result.
	.Pp
	.Bd -literal -offset indent			.Bd -literal -offset indent
	camcontrol zone da0 -v -c rz -o reset			camcontrol zone da0 -v -c rz -o reset
	.Ed			.Ed
	.Pp			.Pp
	This will request the list of SMR zones that should have their write			This will request the list of SMR zones that should have their write
	pointer reset from the disk da0, and display any			pointer reset from the disk da0, and display any
	.Tn SCSI			.Tn SCSI
	or			or
	.Tn ATA			.Tn ATA
	errors that result.			errors that result.
	.Pp
	.Bd -literal -offset indent			.Bd -literal -offset indent
	camcontrol zone da0 -v -c rwp -l 0x2c80000			camcontrol zone da0 -v -c rwp -l 0x2c80000
	.Ed			.Ed
	.Pp			.Pp
	This will issue the Reset Write Pointer command to disk da0 for the zone			This will issue the Reset Write Pointer command to disk da0 for the zone
	that starts at LBA 0x2c80000 and display any			that starts at LBA 0x2c80000 and display any
	.Tn SCSI			.Tn SCSI
	or			or
	.Tn ATA			.Tn ATA
	errors that result.			errors that result.
	.Pp
	.Bd -literal -offset indent			.Bd -literal -offset indent
	camcontrol epc ada0 -c timer -T 60.1 -p Idle_a -e -s			camcontrol epc ada0 -c timer -T 60.1 -p Idle_a -e -s
	.Ed			.Ed
	.Pp			.Pp
	Set the timer for the Idle_a power condition on drive			Set the timer for the Idle_a power condition on drive
	.Pa ada0			.Pa ada0
	to 60.1 seconds, enable that particular power condition, and save the timer			to 60.1 seconds, enable that particular power condition, and save the timer
	value and the enabled state of the power condition.			value and the enabled state of the power condition.
	.Pp
	.Bd -literal -offset indent			.Bd -literal -offset indent
	camcontrol epc da4 -c goto -p Standby_z -H			camcontrol epc da4 -c goto -p Standby_z -H
	.Ed			.Ed
	.Pp			.Pp
	Tell drive			Tell drive
	.Pa da4			.Pa da4
	to go to the Standby_z power state (which is			to go to the Standby_z power state (which is
	the drive's lowest power state) and hold in that state until it is			the drive's lowest power state) and hold in that state until it is
	explicitly released by another			explicitly released by another
	.Cm goto			.Cm goto
	command.			command.
	.Pp
	.Bd -literal -offset indent			.Bd -literal -offset indent
	camcontrol epc da2 -c status -P			camcontrol epc da2 -c status -P
	.Ed			.Ed
	.Pp			.Pp
	Report only the power state of			Report only the power state of
	drive			drive
	.Pa da2 .			.Pa da2 .
	Some drives will power up in response to the commands sent by the			Some drives will power up in response to the commands sent by the
	.Pa status			.Pa status
	subcommand, and the			subcommand, and the
	.Fl P			.Fl P
	option causes			option causes
	.Nm			.Nm
	to only send the			to only send the
	.Tn ATA			.Tn ATA
	CHECK POWER MODE command, which should not trigger a change in the drive's			CHECK POWER MODE command, which should not trigger a change in the drive's
	power state.			power state.
	.Pp
	.Bd -literal -offset indent			.Bd -literal -offset indent
	camcontrol epc ada0 -c list			camcontrol epc ada0 -c list
	.Ed			.Ed
	.Pp			.Pp
	Display the ATA Power Conditions log (Log Address 0x08) for			Display the ATA Power Conditions log (Log Address 0x08) for
	drive			drive
	.Pa ada0 .			.Pa ada0 .
	.Pp
	.Bd -literal -offset indent			.Bd -literal -offset indent
	camcontrol timestamp sa0 -s -f "%a, %d %b %Y %T %z" \e			camcontrol timestamp sa0 -s -f "%a, %d %b %Y %T %z" \e
	-T "Wed, 26 Oct 2016 21:43:57 -0600"			-T "Wed, 26 Oct 2016 21:43:57 -0600"
	.Ed			.Ed
	.Pp			.Pp
	Set the timestamp of drive			Set the timestamp of drive
	.Pa sa0			.Pa sa0
	using a			using a
	▲ Show 20 Lines • Show All 56 Lines • Show Last 20 Lines