Differential D29867 Diff 90228 usr.sbin/devctl/devctl.8

Changeset View

Standalone View

usr.sbin/devctl/devctl.8

	Show All 18 Lines
	.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)			.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
	.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT			.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY			.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF			.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	.\" SUCH DAMAGE.			.\" SUCH DAMAGE.
	.\"			.\"
	.\" $FreeBSD$			.\" $FreeBSD$
	.\"			.\"
	.Dd April 4, 2019			.Dd June 1, 2021
	.Dt DEVCTL 8			.Dt DEVCTL 8
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm devctl			.Nm devctl
	.Nd device control utility			.Nd device control utility
	.Sh SYNOPSIS			.Sh SYNOPSIS
	.Nm			.Nm
	.Cm attach			.Cm attach
	Show All 26 Lines
	.Nm			.Nm
	.Cm rescan			.Cm rescan
	.Ar device			.Ar device
	.Nm			.Nm
	.Cm delete			.Cm delete
	.Op Fl f			.Op Fl f
	.Ar device			.Ar device
	.Nm			.Nm
				.Cm freeze
				.Nm
				.Cm thaw
				.Nm
	.Cm reset			.Cm reset
	.Op Fl d			.Op Fl d
	.Ar device			.Ar device
	.Sh DESCRIPTION			.Sh DESCRIPTION
	The			The
	.Nm			.Nm
	utility adjusts the state of individual devices in the kernel's			utility adjusts the state of individual devices in the kernel's
	internal device hierarchy.			internal device hierarchy.
	▲ Show 20 Lines • Show All 87 Lines • ▼ Show 20 Lines
	Delete the device from the device tree.			Delete the device from the device tree.
	If the			If the
	.Fl f			.Fl f
	flag is specified,			flag is specified,
	the device will be deleted even if it is physically present.			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			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			can no longer be used unless the parent bus device rediscovers the device via
	a rescan request.			a rescan request.
				.It Cm freeze
				Freeze probe and attach processing initiated in response to drivers being
				loaded.
				impUnsubmitted Not Done Inline Actions Drivers are placed on a 'frozen list' and processed when a later 'thaw' occurs. imp: Drivers are placed on a 'frozen list' and processed when a later 'thaw' occurs.
				Drivers are placed on a
				.Do
				0mpUnsubmitted Done Inline Actions "Drivers" or "drivers"? Also, maybe "thaw" instead of "thaws"? 0mp: "Drivers" or "drivers"? Also, maybe "thaw" instead of "thaws"?
				frozen list
				impUnsubmitted Not Done Inline Actions In addition to resuming, all pending actions that were frozen during the freeze are performed. imp: In addition to resuming, all pending actions that were frozen during the freeze are performed.
				.Dc
				and processed when a later
				.Do
				thaw
				.Dc
				occurs.
				.It Cm thaw
				Resume (thaw the freeze) probe and attach initiated in response to drivers
				being loaded.
				In addition to resuming, all pending actions that were frozen during the freeze
				are performed.
	.It Xo Cm reset			.It Xo Cm reset
	.Op Fl d			.Op Fl d
	.Ar device			.Ar device
	.Xc			.Xc
	Reset the device, using bus-specific reset method.			Reset the device, using bus-specific reset method.
	Drivers for the devices being reset are suspended around the reset.			Drivers for the devices being reset are suspended around the reset.
	If the			If the
	.Fl d			.Fl d
	Show All 29 Lines