FWGetLocalHost(TCL_ADM)

Syntax

Description

FWGetLocalHostName

returns the name of the local host (according to the SCOadmin framework). Enables the caller to find out what machine the framework thinks it is running on. By using this value with the systemId naming attribute in Object(TCL_ADM) calls, the client is guaranteed to work on the local host. The framework uses gethostname(SLIB) to identify the local machine.

FWGetLocalHostNameByMethod

returns the name of the local host (according to the current network identification method). Enables the caller to find out what the current network method thinks is the local machine. The framework will use gethostbyname(SLIB) by default (this can be overridden by the value in the /etc/default/scoAdmin file).

---

WARNING: If the local machine has networking software installed but the network is currently down (the machine is in single user state) then this call can take up to five minutes to complete.

This function is no longer used by the framework and is only provided for backwards compatibility. Please use FWGetLocalHostName instead.

---

FWIdentifingHostsByIpMethod

returns 1 if the framework is using Berkeley sockets gethostbyname() system calls to identify the local and remote hosts. It returns 0 otherwise. This enables the caller to find out if the local machine is on a network (provided that the local system administrator has not previously forced the framework to identify host using the uname(S) system call by setting the localPipe:systemIdRecognitionMethod to the UNAME value in the /etc/default/scoAdmin file).

---

WARNING: If the local machine has networking software installed but the network is currently down (ie: the machine is in single user state) then this call can take up to five minutes to complete. Any call to this function should first inform the user that it is about to check the network state; thus the user will be provided with a reason is the program he/she is using hangs for five minutes.

This function should not be used to determine if a UI button (such as Remote Host) should be stippled or not.

---

Files

See also