home | help
ATACONTROL(8)		     System Manager's Manual		   ATACONTROL(8)

NAME
     atacontrol -- ATA device driver control program

SYNOPSIS
     atacontrol <command> args

     atacontrol attach channel
     atacontrol detach channel
     atacontrol reinit channel
     atacontrol create type [interleave] disk0 ... diskN
     atacontrol delete raid
     atacontrol rebuild raid
     atacontrol status raid
     atacontrol mode channel [mastermode slavemode]
     atacontrol info channel
     atacontrol cap channel device
     atacontrol enclosure channel device
     atacontrol list

DESCRIPTION
     atacontrol  is  a control program that provides the user access and control
     to the FreeBSD ata(4) subsystem.

     atacontrol can cause severe system crashes and loss of data if used improp-
     erly, please exercise caution when using this command!

     The channel argument is the number of the ATA channel on which to	operate.
     The following commands are supported:

     attach   Attach  an  ATA channel, devices on the channel are probed and at-
	      tached as is done on boot.

     detach   Detach an ATA channel, devices on the channel are removed from the
	      kernel, and all outstanding transfers etc. are  returned	back  to
	      the system marked as failed.

     reinit   Reinitialize  an ATA channel.  Both devices on the channel are re-
	      set and initialized to the parameters the ATA  driver  has  stored
	      internally.   Devices  that has gone bad and no longer responds to
	      the probe, or devices that has physically been removed are removed
	      from the kernel.	Likewise are devices that show up during  a  re-
	      set, probed and attached.

     create   Create  a  type  ATA  RAID.  The Type can be RAID0 (stripe), RAID1
	      (mirror), RAID0+1 or SPAN (JBOD). In case the  RAID  has	a  RAID0
	      component  the  interleave must be specified in number of sectors.
	      The RAID will be created of the individual disks named  disk0  ...
	      diskN.

	      Allthough  the ATA driver allows for creating an ATA RAID on disks
	      on any controller, there are restrictions. It is only possible  to
	      boot  on	an array if its either located on a "real" ATA RAID con-
	      troller like the Promise or Highpoint controllers, or if the  RAID
	      declared is of RAID1 or SPAN type, in case of a SPAN the partition
	      to boot must reside on the first disk in the SPAN.

     delete   Deletes a RAID array on a RAID capable ATA controller.

     rebuild  Rebuild a RAID1 array on a RAID capable ATA controller.

     status   Get the status of an ATA RAID.

     mode     Without  the two mode arguments the current transfer modes of both
	      devices are printed.  If the mode arguments  are	given,	the  ATA
	      driver  is asked to change the transfer modes to those given.  The
	      ATA driver will reject modes that is not supported  by  the  hard-
	      ware.   Modes are given like "PIO3", "udma2", "udma100", case does
	      not matter.  If one of the devices mode should not be changed, use
	      a nonexisting mode as argument (i.e. "XXX"), and the mode will re-
	      main unchanged.

     info     Show info about the attached devices on the  channel,  the  device
	      name and manufacture/version strings are shown.

     cap      Show detailed info about the device on channel device where device
	      is 0 for master and 1 for slave.

     enclosure
	      Show detailed info about the encolsure on channel device where de-
	      vice  is	0  for master and 1 for slave.	Fan RPM speed, enclosure
	      temperature, 5V and 12V levels are shown.

     list     Show info about all attached devices on all active controllers.

SEE ALSO
     ata(4)

HISTORY
     The atacontrol utility first appeared in FreeBSD 4.6.

AUTHORS
     The atacontrol utility was written by Soren Schmidt <sos@FreeBSD.org>.

     This manual page was written by Soren Schmidt <sos@FreeBSD.org>.

FreeBSD 4.6			  May 17, 2001			   ATACONTROL(8)

home | help