4D Doc Center : NET

4D Internet Commands v14

NET_Finger


NET_Finger ( nomServeur ; texteRecherche ; informations ) -> Résultat

Paramètre	Type	Description
nomServeur	Chaîne	Nom ou adresse IP du serveur
texteRecherche	Chaîne	Texte de la recherche
informations	Texte	Résultats de la recherche
Résultat	Entier	Code d'erreur

Description

La commande NET_Finger permet d'obtenir des informations sur un compte utilisateur enregistré sur un serveur. La commande Unix Finger retourne l'heure de la dernière connexion d'un utilisateur ainsi que des informations supplémentaires que l'utilisateur choisit de fournir dans ses fichiers ".plan" et ".project".
NET_Finger interroge, sur la machine désignée par nomServeur, le compte d'utilisateur spécifié par texteRecherche et retourne le résultat dans le paramètre informations.

Une recherche Finger peut être effectuée de deux manières :

Directement : la recherche est effectuée directement sur la machine de l'utilisateur. Par exemple, pour obtenir des informations sur "johnt" chez "4d.com", vous pouvez écrire :

$erreur:=NET_Finger("www.4d.com";"johnt";$textefinger)

Indirectement : dans ce cas, vous demandez à un serveur distant (qui accepte la commande Finger) d'effectuer la requête. Par exemple, la requête suivante demande à la machine identifiée par le nom de domaine "4d.com" d'effectuer une recherche Finger de l'utilisateur "johnt@4d.com".

$erreur:=NET_Finger("www.4d.com";"johnt@4d.com";$textefinger)

Bien que les principales informations renvoyées dans chaque cas soient globalement identiques, de légères différences peuvent être constatées. En effet, les paramétrages d'exécution de la commande Finger peuvent différer d'une machine à l'autre. En outre, des différences de formatage peuvent apparaître entre les résultats d'une commande Finger directe et ceux d'une commande indirecte, les recherches indirectes contenant souvent des retours à la ligne (line feed) supplémentaires.

Le paramètre nomServeur contient le nom ou l'adresse IP du serveur sur lequel l'utilisateur identifié par texteRecherche a un compte.

Le paramètre texteRecherche contient soit le texte à rechercher sur un serveur Finger, soit le nom ou l'adresse IP d'une machine. Si vous passez un nom d'utilisateur dans texteRecherche, la commande le recherchera dans le répertoire des noms d'utilisateurs du serveur. Si vous passez un nom de machine ou une adresse IP, la commande enverra la requête Finger à la machine spécifiée par l'intermédiaire du serveur Finger nomServeur.

Le paramètre informations retourne le résultat de la recherche.