Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
DEVCTL(8)		FreeBSD	System Manager's Manual		     DEVCTL(8)

NAME
     devctl -- device control utility

SYNOPSIS
     devctl attach device
     devctl detach [-f]	device
     devctl disable [-f] device
     devctl enable device
     devctl suspend device
     devctl resume device
     devctl set	driver [-f] device driver
     devctl rescan device
     devctl delete [-f]	device

DESCRIPTION
     The devctl	utility	adjusts	the state of individual	devices	in the ker-
     nel's internal device hierarchy.  Each invocation of devctl consists of a
     single command followed by	command-specific arguments.  Each command
     operates on a single device specified via the device argument.  The
     device may	be specified either as the name	of an existing device or as a
     bus-specific address.  More details on supported address formats can be
     found in devctl(3).

     The following commands are	supported:

     attach device
	     Force the kernel to re-probe the device.  If a suitable driver is
	     found, it is attached to the device.

     detach [-f] device
	     Detach the	device from its	current	device driver.	If the -f flag
	     is	specified, the device driver will be detached even if the
	     device is busy.

     disable [-f] device
	     Disable a device.	If the device is currently attached to a
	     device driver, the	device driver will be detached from the
	     device, but the device will retain	its current name.  If the -f
	     flag is specified,	the device driver will be detached even	if the
	     device is busy.

     enable device
	     Enable a device.  The device will probe and attach	if a suitable
	     device driver is found.  Note that	this can re-enable a device
	     disabled at boot time via a loader	tunable.

     suspend device
	     Suspend a device.	This may include placing the device in a
	     reduced power state.

     resume device
	     Resume a suspended	device to a fully working state.

     set driver	[-f] device driver
	     Force the device to use a device driver named driver.  If the
	     device is already attached	to a device driver and the -f flag is
	     specified,	the device will	be detached from its current device
	     driver before it is attached to the new device driver.  If	the
	     device is already attached	to a device driver and the -f flag is
	     not specified, the	device will not	be changed.

     rescan device
	     Rescan a bus device checking for devices that have	been added or
	     removed.

     delete [-]	device
	     Delete the	device from the	device tree.  If the -f	flag is	speci-
	     fied, the device will be deleted even if it is physically
	     present.  This command should be used with	care as	a device that
	     is	deleted	but present can	no longer be used unless the parent
	     bus device	rediscovers the	device via a rescan request.

SEE ALSO
     devctl(3),	devinfo(8)

HISTORY
     The devctl	utility	first appeared in FreeBSD 10.3.

FreeBSD	11.1			April 27, 2016			  FreeBSD 11.1

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | HISTORY

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=devctl&sektion=8&manpath=FreeBSD+11.0-RELEASE+and+Ports>

home | help