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

FreeBSD Manual Pages

  
 
  

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

NAME
     iovctl -- PCI SR-IOV configuration utility

SYNOPSIS
     iovctl -C -f config-file [-n]
     iovctl -D [-f config-file | -d device] [-n]
     iovctl -S [-f config-file | -d device]

DESCRIPTION
     The  iovctl  utility creates or destroys PCI Single-Root I/O Virtualization
     (SR-IOV) Virtual Functions (VFs).	When invoked with the  -C  flag,  iovctl
     creates  VFs  as  children  of the Physical Function (PF) configured in the
     specified configuration file.  When invoked with the -D  flag,  iovctl  de-
     stroys all VFs that are children of the specified device.	Available PF de-
     vices can be seen in /dev/iov/.

     The following options are available:

     -C      Enable  SR-IOV  on  the specified PF device and create VF children.
	     This operation will fail if the PF already has VF	children.   This
	     option must be used in conjunction with the -f option.

     -d device
	     Specify  the  PF device to use for the given operation.  device may
	     either be the name of a PF device, or a full path name to a node in
	     /dev/iov/.  This option may not be used with the -C option.

     -D      Delete all VF children of the specified PF device.  This  operation
	     will  fail  if SR-IOV is not currently enabled on the specified de-
	     vice.

     -f config-file
	     Specify the pathname of the configuration file.  For the -C option,
	     this file will be used to specify all  configuration  values.   For
	     the  -D  and -S options, this file will only be used to specify the
	     name of the PF device.

	     See iovctl.conf(5) for a description of the config file format  and
	     documentation  of the configuration parameters that apply to all PF
	     drivers.  See the PF driver manual page for  configuration  parame-
	     ters specific to particular hardware.

     -n      Perform  a dry-run.  Perform all validation of the specified action
	     and print what would be done, but do not perform  the  actual  cre-
	     ation  or destruction of VFs.  This option may not be used with the
	     -S flag.

     -S      Read the configuration schema from the specified device  and  print
	     its  contents  to	stdout.  This action may be used to discover the
	     configuration parameters supported on a given PF device.

SEE ALSO
     iovctl.conf(5), rc.conf(5)

AUTHORS
     This manual page was written by Ryan Stone <rstone@FreeBSD.org>.

FreeBSD ports 15.quarterly	  May 31, 2020			       IOVCTL(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=iovctl&manpath=FreeBSD+15.1-RELEASE+and+Ports.quarterly>

home | help