fddiinit(1M)

NAME

fddiinit — initialize FDDI network interface; connect to FDDI network

SYNOPSIS

/usr/sbin/fddiinit [-l download_file] [-s] device_file

DESCRIPTION

fddiinit:

Downloads firmware to the FDDI network interface and connects the interface to the FDDI network.
Must be executed for each interface present on a machine.
Is also executed from within the fddi initialization script during network initialization.
Is also used to reinitialize and reconnect the interface after the interface has been reset. Use the fddistop command to reset the interface (see fddistop(1M)).

Options and Command-Line Arguments

fddiinit recognizes the following options and command-line arguments:

-l download_file: Specifies the firmware download file. See DEPENDENCIES for machine-dependent details.
-s: (silent) Suppress the progress message. While fddiinit is running, it periodically prints a series of dots on the terminal screen to indicate that the firmware download is in progress. When the -s option is specified, the dots will not be printed.
device_file: Specifies the device special file associated with the FDDI interface. By convention, device special files are kept in the /dev directory. Each device file has a name and a device number to uniquely identify the interface. See DEPENDENCIES for a description of how to create device files.

RETURN VALUE

Upon successful completion, fddiinit returns 0; otherwise, it returns 1.

ERRORS

fddiinit fails and the firmware is not downloaded if any of the following conditions are encountered:

Command used incorrectly - usage message is returned.
Invalid device file - returns message Can't open device file. Check the device file. See DEPENDENCIES for description of how to create device files.
Invalid download file - returns Can't open download file or Invalid file format. Contact your HP Customer Support representative.
Hardware or driver error - download was unsuccessful because of a hardware or firmware problem. Check to ensure that hardware is correctly connected. If the download is still unsuccessful, replace the card with a known-good unit if one is available, and retry the command. Otherwise, contact your HP customer support representative.

DEPENDENCIES

Series 700 Built-In FDDI:

Each device file has a name and a device number to uniquely identify the interface. To create the Built-In FDDI device file manually (instead of through SAM), specify the applicable major and minor numbers in the HP-UX /usr/sbin/mknod command. Built-In FDDI device files have the following major and minor numbers:

Major	Minor	Card Instance number
111	0xYY0000	YY

The following example uses /usr/sbin/mknod to create the Built-In FDDI device special file /dev/lan1 on the FDDI Built-In card device with a card instance of 1:

/usr/sbin/mknod /dev/lan1 c 111 0x010000

If the FDDI interface card is configured using SAM (see sam(1M)), SAM creates the device file automatically and the name corresponds to the network interface name and unit. For example, device files /dev/lan1 and /dev/lan2 are for network interfaces lan1 and lan2 respectively. You can also use the /usr/sbin/lanscan command to display information about the network interfaces on the system.

fddiinit does not require a download file for the Built-In FDDI card.

Series 800:

Device files for HPPB FDDI are created automatically by /usr/sbin/insf (see insf(1M)) when the system is rebooted after installing the HPPB FDDI driver and adapter card. The device file name is of the form /dev/lanX where X >= 0.

The major number for HPPB FDDI device files is 191. The minor number containing the card instance number is assigned based on the configuration of the HPPB FDDI card in the HPPB backplane relative to other LAN cards. Each LAN card has a unique minor device number.

To determine the device special file corresponding to a particular FDDI adapter, first use the /usr/sbin/lanscan command (see lanscan(1M)) to obtain the card instance number that matches the hardware path of that adapter. Then use the /usr/sbin/lssf command (see lssf(1M)) on those files in the /dev directory that have a major number of 191 to find a file that has a matching card instance number.

mksf (see mksf(1M)) can be used to manually create a device file for the HPPB FDDI interface.

The default download file is /usr/lib/fddi_dnld. This download file is used for the HPPB FDDI card.

AUTHOR

fddiinit was developed by HP.

FILES

/usr/lib/fddi_dnld: default FDDI download file.