.\" Automatically generated from mdocxml
.Dd October 27, 2004
.Dt "fibreconfig" 8
.Os "Mac OS X"
.Sh NAME
.Nm fibreconfig
.Nd Tool for configuring settings for Fibre Channel controllers and targets.
.Sh SYNOPSIS
.Nm
.Op Fl r
.Op Fl c Ar xx:xx:xx:xx:xx:xx:xx:xx
.Op Fl a Ar AL_PA
.Op Fl s Ar port_speed
.Op Fl t Ar topology_type
.Op Fl l
.Op Fl v
.Sh OPTIONS
The available options are as follows:
.Bl -tag -width XXXXXXXXXX
.It Fl r
Dynamically updates system settings. Note: Cannot be used in conjunction with -c option.
.It Fl c
Defines the host port used for an operation. By default, if no other options are specified, fibreconfig will display information about the specified host port. 
.It Fl a
Sets the AL_PA for specified host port. The AL_PA must be one of the values defined in Table 1.1 located in the examples section.
.It Fl s
Sets speed to [ 1gigabit, 2gigabit, 4gigabit, auto ] for specified host port.
.It Fl t
Sets topology to [ nport, nlport, auto ] for specified host port.
.It Fl l
Lists all known information about all nodes ( controllers, targets, and their LUNs ).
.It Fl v
Display version number.
.El
.Sh RETURN VALUES
Returned Error Code
.Pp
0 				No error.
.Pp
-50 				Error in user parameter list.
.Pp
.Sh FILES
.Bl -tag -width indent
.It Pa /sbin/fibreconfig
Executable for version 2.0 and later.
.El
.Sh EXAMPLES
.Bl -enum
.It
Set the AL_PA to 1E for a given host port.
.Pp
fibreconfig -c 00:11:22:33:44:55:66:77 -a 1E
.Pp
.It
Disable the AL_PA for a given host port.
.Pp
fibreconfig -c 00:11:22:33:44:55:66:77 -a FF
.Pp
.It
Set the speed to auto for a given host port.
.Pp
fibreconfig -c 00:11:22:33:44:55:66:77 -s auto
.Pp
.It
Set the topology to nlport for a given host port.
.Pp
fibreconfig -c 00:11:22:33:44:55:66:77 -t nlport
.Pp
.It
Table 1.1 List of valid AL_PA settings:
.Pp
=======================================
.Pp
01 02 04 08 0F 10 17 18 1B 1D 1E 1F 23 25 26 27 29 2A 2B 2C 2D 2E 31 32 33 34 35 36 39 3A 3C 43 45 46 47 49 4A 4B 4C 4D 4E 51 52 53 54 55 56 59 5A 5C 63 65 66 67 69 6A 6B 6C 6D 6E 71 72 73 74 75 76 79 7A 7C 80 81 82 84 88 8F 90 97 98 9B 9D 9E 9F A3 A5 A6 A7 A9 AA AB AC AD AE B1 B2 B3 B4 B5 B6 B9 BA BC C3 C5 C6 C7 C9 CA CB CC CD CE D1 D2 D3 D4 D5 D6 D9 DA DC E0 E1 E2 E4 E8 EF 
.El
.Pp
.Sh DIAGNOSTICS
Return value on exit provides information about the success or failure of the utility. 
.Sh ERRORS
See return values. 
.Sh HISTORY
Last updated February 1, 2005. 
.Sh BUGS
Known issues:
.Pp
.Bl -enum
.It
Currently only displays information for Apple shipped Fibre Channel cards.
.El
.Pp