Nom

smbclient - un client similaire au ftp pour accéder à des ressources SMB/CIFS sur les serveurs.

Résumé

smbclient nom_de_service [ mot_de_passe ] [ -b <taille_de_buffer> ] [ -d niveau_de_deboggage ] [ -D repertoire ] [ -U utilisateur ] [ -W groupe_de_travail ] [ -M <nom_netbios> ] [ -m maxprotocol ] [ -A fichier_d_autorisations ] [ -N ] [ -l fichier_de_log ] [ -L <nom_netbios> ] [ -I IP_de_destination ] [ -E <code_de_terminal> ] [ -c <ligne_de_commande> ] [ -i scope ] [ -O <options_de_socket> ] [ -p port ] [ -R <ordre_de_résolution_de_noms> ] [ -s <fichier_de_configuration_smb> ] [ -T<c|x>IXFqgbNan ]

Description


Ce programme fait partie de la suite logicielle Samba.

smbclient est un client capable de dialoguer avec un serveur SMB/CIFS. Il offre une interface très similaire à celle du programme ftp(1)). Les opérations proposées par ce programme permettent entre autres de télécharger des fichiers du client vers le serveur dans les deux sens, d'obtenir des informations sur les fichiers présents sur le serveur et ainsi de suite.

Options

nom_de_service nom_de_service est le nom du service auquel vous désirez accéder sur le serveur. Un tel nom est de la forme //serveur/service où serveur est le nom NetBIOS du serveur SMB/CIFS qui propose le service nommé service. Ainsi, pour se connecter au service « printer » (N.d.T. : imprimante en anglais) sur le serveur SMB/CIFS « serveurSMB », on utiliserait le nom de service //serverSMB/printer. Il faut noter que le nom de serveur demandé n'est PAS nécessairement le nom de machine IP (résolu par DNS) du serveur, mais le nom NetBIOS du serveur qui ne correspond pas forcément. Le nom du serveur est résolu en se basant sur un éventuel paramètre -R passé à smbclient ou selon l'ordre spécifié dans la rubrique concernant l'ordre de résolution des noms dans le fichier de configuration smb.conf, ce qui permet à l'administrateur de modifier l'ordre et les méthodes utilisées pour résoudre les noms de serveur.

mot_de_passe Le mot de passe demandé pour accéder au service spécifié sur le serveur demandé. Si ce paramètre est fourni, l'option -N (suppression de la demande de mot de passe) est utilisée implicitement. Il n'y a pas de mot de passe par défaut. Si aucun mot de passe n'est fourni sur la ligne de commande (soit en utilisant ce paramètre, soit en ajoutant un mot de passe à l'option -U - voir ci-dessous), le client demandera un mot de passe même si le service demandé n'en nécessite aucun (Si aucun mot de passe n'est requis, pressez simplement ENTRÉE pour fournir un mot de passe vide). Note : Certains serveurs (notament OS/2 et Windows 3.11) insistent pour avoir un mot de passe en majuscules. Les mots de passe en minuscules ou avec des combinaisons minuscules et majuscules peuvent être rejetés par certains de ces serveurs. Faites attention lorsque vous incluez des mots de passe dans des scripts (N.d.T. : surtout si ces scripts sont visibles par des personnes non autorisées !)

-s smb.conf Indique l'emplacement du fichier de configuration smb.conf.

-O options_socket Les options pour les sockets à fixer pour le client. Consultez les paramètres de ces options dans la page de man smb.conf(5) pour une liste complète des options valides.

-R <ordre_de_résolution_des_noms> Cette option est utilisée par les programmes de la suite logicielle Samba pour déterminer quels services utiliser et dans quel ordre, ceci afin de résoudre le nom d'une machine et de lui faire correspondre une adresse IP. Cette option prend une chaîne de caractères dont les éléments sont séparés par des espaces. Les options disponibles sont : « lmhosts », « host », « wins », « bcast » et correspondent à ces différentes actions :      (bu lmhosts : Recherche une adresse IP dans le fichier lmhosts de Samba. Si la ligne dans le fichier lmhosts n'a pas de type attaché au nom NetBIOS (consultez lmhosts(5) pour plus de détails) alors, n'importe quel type correspondra à la requête ;      (bu host : Effectue une résolution de l'adresse IP standard en utilisant le fichier système /etc/hosts (N.d.T. : consultez hosts(5) pour plus de détails), NIS (N.d.T. : Network Information Service, un service utilisé entre autres dans les intranets pour partager des informations sur les différentes machines), ou DNS (N.d.T. : « Domain Name Service », un service utilisé sur Internet pour faire correspondre à un nom de machine une IP) pour effectuer la résolution de noms. Cette méthode de résolution dépend du système d'exploitation, par exemple, sous IRIX ou Solaris, cela peut être contrôlé par le fichier /etc/nsswitch.conf. Notez que cette méthode n'est utilisée que dans le cas où le type du nom de machine demandé est 0x20 (un serveur), dans le cas contraire, elle est ignorée.      (bu wins : Demande un nom à partir des adresses IP enregistrées dans le paramètre serveur_wins. Si aucun serveur WINS n'a été spécifié, cette méthode sera ignorée.      (bu bcast : Effectue un « broadcast » (N.d.T. : une diffusion sur tout le réseau) sur chacune des interfaces locales connues spécifiées dans le paramètre interfaces. C'est la méthode de résolution la plus disponible mais elle dépend de la présence de l'hôte recherché sur le sous-réseau local.

Si ce paramètre n'a pas été précisé, alors l'ordre de résolution utilisé sera celui indiqué dans le fichier de configuration smb.conf (avec « name resolve order », c'est à dire « ordre pour la résolution des noms » comme nom de paramètre).


L'ordre par défaut appliqué si ce paramètre n'est pas indiqué et si cet ordre n'est pas présent dans dans smb.conf est lmhosts, host, wins, bcast.

-M nom_NetBIOS Ces options vous permettent d'envoyer des messages à travers le protocole « WinPopup » à un autre ordinateur. Une fois que la connexion est établie, vous entrez votre message et utilisez ^D (touches Control-D) pour quitter et envoyer le message. Si WinPopup fonctionne sur l'ordinateur cible, l'utilisateur recevra le message et sans doute un signal sonore, dans le cas contraire, le message sera perdu et aucun message d'erreur ne sera envoyé. Le message sera automatiquement tronqué à 1600 caractères s'il dépasse cette limite due au protocole. Une astuce utile est d'envoyer le message à travers la commande cat (N.d.T. : ou echo) vers smbclient. Par exemple : cat mon_message.txt | smbclient -M FRED enverra le message contenu dans le fichier mon_message.txt à la machine FRED. Vous pouvez aussi utiliser les options -U et -I qui vous permettront de contrôler les champs FROM (N.d.T. : « De la part de ») et TO (N.d.T. : « adressé à ») du message. Consultez le paramètre des commandes de message dans le fichier smb.conf(5) pour une description de la manière dont Samba doit traiter les messages WinPopup entrants (N.d.T. : Il existe aussi des utilitaires tels que linpopup qui simule le client WinPopup). Note: Copiez WinPopup dans les programmes démarrés automatiquement de vos PC pour recevoir de tels messages (N.d.T. : ou démarrez le service associé sur les Systèmes d'exploitation dérivés de Windows NT).

-i scope Permet de préciser la gamme d'adresses IP qu'utilisera smbclient pour générer les noms NetBIOS. Pour davantage de détails sur les noms NetBIOS, consultez les documents rfc1001.txt et rfc1002.txt. Les gammes d'adresses ne sont que rarement utilisées, ne fixez ce paramètre que si vous êtes l'administrateur système en charge de toutes les machines NetBIOS avec lesquelles vous désirez communiquer.

-N Si précisé, ce paramètre supprime la demande de mot de passe que le client demande à l'utilisateur. Cela peut être utile lorsque vous accédez à un service ne nécessitant pas de mot de passe. À moins qu'un mot de passe ne soit spécifié sur la ligne de commande ou que ce paramètre soit utilisé, le client demandera dans tous les cas un mot de passe.

-n nom_NetBIOS Par défaut, le client utilisera le nom local de machine comme nom NetBIOS. Ce paramètre vous permet de changer ce comportement et d'utiliser le nom NetBIOS que vous désirez.

-d niveau_de_déboggage Un nombre compris entre 0 et 10, ou bien la lettre « A ». La valeur par défaut de ce paramètre est 0. Plus haute est la valeur de ce paramètre, plus les fichiers de logs seront détaillés sur les actions du client. Au niveau 0, seuls les erreurs et avertissements critiques seront reportés dans le fichier de log. Le niveau 1 est un niveau raisonnable pour une utilisation quotidienne car il génère un niveau informatif raisonnable sur les actions effectuées. Les niveaux de déboggage supérieurs à 1 généreront une quantité importante de données de log et ne devraient être utilisés que lors de la recherche d'un problème. Les niveaux supérieurs à 3 ne devraient être utilisés que par les développeurs car ils génèrent un énorme flux de données imperméables au non-initié. Si niveau_de_déboggage a pour valeur « A » (N.d.T. : « All », c'est à dire « tout » en anglais), alors tous les messages de déboggage seront reportés. Ce réglage n'est utile qu'aux développeurs ainsi qu'aux personnes souhaitant vraiment savoir comment fonctionne le code en interne. Préciser ici cette valeur masquera le réglage du paramètre « log level » dans le fichier smb.conf (5).

-p port Ce nombre est le port TCP qui sera utilisé quand des connexions seront opérées avec le serveur. Le port TCP standard pour un serveur SMB/CIFS est 139, utilisé par défaut.

-l fichier_de_log_de_base Si précisé, fichier_de_log_de_base indique un nom de fichier dans lequel les informations de fonctionnement du client exécuté seront incrites. Le nom du fichier par défaut est précisé au moment de la compilation. Le nom de base est utilisé pour créer un nom pour le fichier de log courant. Par exemple, si le nom spécifié est « log », le fichier de déboggage sera log.client. Le fichier de log n'est jamais supprimé par le client.

-h Affiche l'aide succincte (N.d.T. : les différents paramètres et options) du client.

-I adresse-IP adresse-IP représente l'adresse du serveur auquel se connecter. Elle doit être écrite dans la notation « a.b.c.d » standard. En pratique, le client essaiera de trouver le serveur SMB/CIFS nommé en interrogeant le mécanisme de résolution de noms NetBIOS décrit dans le paramètre name resolve order (N.d.T. : ordre de résolution des noms). Utiliser ce paramètre forcera le client à considérer que le paramètre indiquant l'adresse IP est le serveur à contacter. De fait, le nom NetBIOS du serveur sera ignoré. Il n'y a pas de valeur par défaut pour ce paramètre. S'il est fourni, il sera déterminé automatiquement par le client comme décrit ci-dessus.

-E Ce paramètre force le client à écrire les messages sur la sortie d'erreur standard (stderr) au lieu d'utiliser la sortie standard. Par défaut, le client écrit les messages sur la sortie standard, habituellement, le tty utilisateur.

-U utilisateur[%mot_de_passe] Fixe le nom d'utilisateur SMB et le mot de passe. Si %mot_de_passe n'est pas précisé, l'utilisateur sera interrogé. Le client consulte et met en majuscules d'abord la valeur de la variable d'environnement USER, puis la variable LOGNAME, si l'une d'elles existe. Tout ce qui se trouve après un « % » dans ces variables sera considéré comme un mot de passe. Si ces variables d'environnement ne sont pas définies, le nom d'utilisateur GUEST (N.d.T. : invité) est utilisé. Si le mot de passe n'est pas inclus dans ces variables d'environnement (en utilisant la syntaxe %mot_de_passe), smbclient consultera alors la variable d'environnement PASSWD pour y lire le mot de passe. Une troisième option possible est d'utiliser un fichier texte contenant le nom et le mot de passe. Cette option est utile pour les scripts dans lesquels l'administrateur ne souhaite pas fournir le nom d'utilisateur et le mot de passe à partir de la ligne de commande ou des variables d'environnement. Bien sûr, si cette option est employée, veillez à ce que les permissions sur ce fichier le protègent des utilisateurs ne devant pas y avoir accès. Consultez l'option -A pour de plus amples détails. Faites attention lorsque vous incluez des mots de passe dans des scripts ou dans la variable d'environnement PASSWD. Il faut également songer au fait que sur de nombreux systèmes, la commande ps permet d'obtenir la ligne de commande ayant lancé le programme en cours d'exécution, et ainsi de récupérer le mot de passe. Il est donc plus sage de toujours permettre smbclient de demander lui-même le mot de passe et de le taper directement de manière interactive.

-A nom_de_fichier Cette option vous permet d'indiquer un fichier pour y lire le nom d'utilisateur et le mot de passe utilisés pour la connexion. Le format de ce fichier doit être de la forme : .nf username = <nom_d'utilisateur> password = <mot_de_passe> .fi Soyez certains que les permissions d'accès au fichier restreignent l'accès aux utilisateurs indésirables.

-L Cette option vous permet de consulter les services disponibles sur un serveur. smbclient -L hôte devrait vous montrer une liste. Vous pouvez éventuellement utiliser l'option -I si votre nom NetBIOS ne correspond pas au nom TCP/IP DNS ou si vous tentez d'accéder à un hôte sur un autre réseau que le vôtre.

-t code_de_terminal Cette option indique à smbclient comment interpréter les noms de fichiers venant du serveur distant. Souvent les implémentations des langages asiatiques utilisent des correspondances de caractères différentes de celles des serveurs SMB/CIFS servers (EUC au lieu de SJIS par exemple). Utiliser ce paramètre permettra à smbclient d'effectuer correctement les conversions entre les noms de fichier UNIX et SMB. Cependant, cette option n'a pas encore été très rigoureusement testée et pourrait comporter des problèmes. Les codes de terminal comprennent CWsjis, CWeuc, CWjis7, CWjis8, CWjunet, CWhex, CWcap. Ce n'est pas une liste complète, consultez le code source de Samba pour obtenir une liste exhaustive.

-b taille_de_tampon Cette option modifie la taille des tampons de réception et d'émission utilisés lorsque qu'un fichier est envoyé/reçu par/vers le serveur. Par défaut, sa valeur est de 65520 octets. Il a été observé qu'utiliser une valeur plus petite (à 1200 octets) permettait d'accélérer les transferts en provenance et vers un serveur Win9x.

-W GROUPE_DE_TRAVAIL Permet d'utiliser pour la connexion courante une valeur différente pour le groupe de travail (domaine) de celle inscrite dans le paramètre workgroup (N.d.T. : groupe de travail) du fichier smb.conf. Cela peut-être utile pour se connecter à certains serveurs.

-T options_de_tar smbclient peut-être utilisé pour créer des sauvegardes compatibles avec tar(1) de tous les fichiers partagés d'un serveur SMB/CIFS. Les valeurs de ce paramètre sont :      (bu c - Créer un fichier tar sur UNIX. Doit être suivi par le nom du fichier tar, du périphérique à bande magnétique ou « - » pour la sortie standard. Si vous utilisez la sortie standard, vous devez mettre la valeur la plus faible pour le niveau de log en utilisant l'option -d0 pour éviter d'endommager votre fichier tar. Ce paramètre ne peut être utilisé avec le paramètre tar « x ».      (bu x - extrait (restaure) un fichier local tar vers un partage. À moins que l'option -D ne soit donnée, les fichiers contenus dans le tar seront restaurés à la racine du partage. Cette option doit être suivie par le nom du fichier tar, du périphérique ou de « - » pour l'entrée standard. Ce paramètre ne peut être utilisé conjointement avec l'option tar « c ». Les fichiers restaurés auront leur date de création (mtime) fixée à la date de leur incorporation dans le fichier tar. À l'heure actuelle, les répertoires n'ont en revanche pas leur date de création restaurée de manière correcte.      (bu I - Inclure les fichiers et les répertoires. C'est le comportement par défaut quand les noms de fichiers sont précisés comme indiqué ci-dessus. Cela inclut les fichiers lors d'une création ou d'une extraction d'archive (et donc, exclut tous les autres fichiers). Consultez les exemples ci-dessous pour plus d'informations. L'expansion des métacaractères dans les noms de fichiers peut fonctionner selon deux modes, consultez r ci-dessous.      (bu X - Exclure les fichiers et les répertoires. Cette option exclura les fichiers de l'archive tar lors d'une extraction ou d'une création. L'expansion des métacaractères dans les noms de fichier peut fonctionner selon deux modes, consultez r ci-dessous.      (bu b - taille_de_blocs. Doit être suivie par une taille de blocs valide (supérieure à 0). Le fichier tar sera écrit en taille_de_blocs*TBLOCKS (512 octets la plupart du temps) blocs.      (bu g - Incrémentale. Seulement les fichiers de sauvegarde qui ont le drapeau d'archive positionné. Utile uniquement avec le paramètre c.      (bu q - Silencieux. Empêche tar d'imprimer des diagnostics pendant son fonctionnement à la manière du mode silencieux de tar.      (bu r - Expression rationnelle à inclure ou exclure. Utilise les expressions rationnelles pour exclure ou inclure les fichiers si Samba a été compilé avec l'option HAVE_REGEX_H. Cependant, ce mode peut être très lent. Si l'option n'a pas été utilisée à la compilation, effectue des remplacement limités avec les métacaractères « * » et « ? ».      (bu N - Plus nouveau que (N.d.T. : « Newer » an anglais). Doit être suivi par le nom d'un fichier dont la date est comparée aux fichiers trouvés sur le partage au moment de la création du tar. Seuls les fichiers plus récents que le fichier indiqué seront sauvegardés dans le fichier tar. Utile uniquement avec l'option c.      (bu a - Positionne le bit d'archive. Réinitialise le bit d'archive quand un fichier est sauvegardé Utile uniquement avec les options g et c.

Noms de fichiers Tar longs


l'option tar de smbclient supporte désormais les noms de fichiers longs pendant la sauvegarde et la restauration. Cependant, le chemin complet du fichier doit être composé de moins de 1024 octets. Ainsi, lorsque une archive tar est créée, l'option tar de smbclient place tous les fichiers de l'archive avec des noms relatifs et non avec des chemins absolus.


Noms de fichiers Tar


Tous les noms de fichiers peuvent être donnés avec des chemins DOS (avec des '\' comme séparateurs) ou comme des chemins UNIX (avec des '/' comme séparateurs)


Exemples :


Restaurer à partir du fichier tar sauvegarde.tar dans monpartage sur monpc (pas de mot de passe sur le partage)


smbclient //monpc/monpartage "" -N -Tx sauvegarde.tar .PP

Restaurer tout hormis users/docs


smbclient //monpc/monpartage "" -N -TXx sauvegarde.tar users/docs


Créer un fichier tar des fichiers contenus dans users/docs.


smbclient //monpc/monpartage "" -N -Tc sauvegarde.tar users/docs


Pour créer le même fichier tar que ci-dessus, mais en utilisant un nom de fichier DOS.


smbclient //monpc/monpartage "" -N -tc sauvegarde.tar usersedocs


Créer un fichier tar de tous les fichiers et les répertoires dans le partage.


smbclient //monpc/monpartage "" -N -Tc sauvegarde.tar * .PP

-D répertoire_initial Change de répertoire pour répertoire_initial avant de commencer. Sa seule utilisation est sans doute avec l'option tar -T.

-c ligne_de_commande ligne_de_commande est une liste de commandes séparées par des points-virgules à xécuter au lieu de demander depuis « l'invite de commande » sur l'entrée standard. -N est sous-entendue par -c. C'est très utile en particulier dans les scripts et pour afficher stdin (N.d.T. : l'entrée standard) sur le serveur, par exemple : -c 'print -'.

Opérations


Une fois le client démarré, l'utilisateur se retrouve face à une invite de commande :

smb:>

L'antislash (N.d.T. : barre de division inversée ("") indique le répertoire de travail courant sur le serveur et sera modifié si ce répertoire change par la suite.

L'invite de commande indique que le client est prêt et attend une commande de l'utilisateur. Chacune de ces commandes est un mot unique, parfois suivie de paramètres spécifiques à cette commande. Les commandes et les paramètres sont séparés par des espaces à moins que cela ne soit précisé autrement. Toutes les commandes ne sont pas sensibles aux différences entre majuscules et minuscules, en revanche, pour les paramètres, cela dépend de la commande.

Vous pouvez indiquer des noms de fichier contenant des espaces en protégeant les noms avec des guillemets (") par exemple "un nom de fichier long".

Les paramètres décrits avec des crochets (par exemple « [paramètre] ») sont optionnels. Si ils ne sont pas fournis, la commande utilisera les valeurs par défaut qui conviennent. Les paramètres compris entre des signes inférieur et supérieur (par exemple « <paramètre> ») sont quant à eux obligatoires.

Notez que toutes les commandes ayant un effet sur le serveur sont actuellement effectuées en envoyant une requête au serveur. Leur effet peut donc être variable d'un serveur à l'autre, selon les différentes implémentations.

Les commandes disponibles sont données selon l'ordre alphabétique.

? [commande] Si commande est précisé, le ? affichera un message informatif concis a propos de ladite commande. Si commande n'est pas précisé, une liste des commandes disponibles sera affichée.

! [commande shell] Si commande shell est précisée, la commande ! exécutera sur la machine locale un shell (N.d.T. : l'invite de commande) et la commande indiquée. Si l'argument n'est pas fourni, une invite de commande est exécutée.

cd [nom_de_répertoire] Si « nom_de_répertoire » est indiqué, le répertoire de travail courant sur le serveur sera changé avec ce nouveau répertoire. Cette opération échouera si pour une raison ou une autre, le répertoire indiqué est inaccessible. Si aucun nom de répertoire n'est précisé, le répertoire courant sera affiché.

del <masque> Le client demandera au serveur d'essayer d'effacer les fichiers qui correspondent au masque à partir du répertoire courant de travail sur le serveur.

dir [masque] Une liste des fichiers correspondant à masque dans le répertoire de travail courant sur le serveur sera rapatriée du serveur et affichée.

exit Termine la connexion avec le serveur puis termine le programme.

get <nom_de_fichier_distant> [nom_de_fichier_local] Copie le fichier appelé nom_de_fichier_distant depuis le serveur vers la machine exécutant le client. Si précisé, nomme la copie locale nom_de_fichier_local. Notez que tous les transferts effectués par smbclient sont en mode binaire. Voir aussi la commande lowercase.

help [commande] Voir la commande ? ci-dessus.

lcd [nom_de_répertoire] Si nom_de_répertoire est indiqué, le répertoire de travail courant sur la machine locale sera modifié par le nom précisé. Cette commande échouera si, pour une raison ou une autre, le répertoire choisi est inaccessible. Si aucun répertoire n'est spécifié, le nom du répertoire courant sur la machine locale sera affiché.

lowercase Change la mise en minuscules des noms de fichiers pour les commandes get et mget. Quand la mise en minuscule est activée, les noms de fichiers locaux sont convertis en minuscules quand on utilise les commandes get et mget. C'est souvent utile quand on copie des fichiers MSDOS depuis un serveur car la norme sur les systèmes UNIX est d'utiliser des minuscules dans les noms de fichiers.

ls <masque> Voir la commande dir ci-dessus.

mask <masque> Cette commande permet à l'utilisateur de mettre un masque qui sera utilisé pendant des opérations récursives des commandes mget et mput. Le masque utilisé par les commandes mget et mput fonctionne comme un filtre sur les répertoires plutôt que sur les fichiers quand l'action récursive est activée. Le masque indiqué avec cette commande est nécessaire pour filtrer les fichiers à l'intérieur des répertoires. Par exemple, si le masque indiqué dans une commande mget est « source* », que le masque de la commande mask est « *.c » et que la récursivité est active, la commande mget récupérera tous les fichiers correspondants à « *.c » dans tous les sous-répertoires correspondants au motif « source* » à partir du répertoire de travail courant. Notez que la valeur par défaut est vide (équivalent à « * ») et demeure ainsi jusqu'à l'appel de la commande mask pour la modifier. De même, après une modification, elle restera inchangée jusqu'au prochain appel de mask. Pour éviter des résultats inattendus, il est conseillé de modifier la valeur du masque à « * » après avoir utilisé les commandes mget ou mput.

md <nom_de_répertoire> Voir la commande mkdir.

mget <masque> Copie tous les fichiers correspondant à masque depuis le serveur vers la machine exécutant le client. Notez que masque est interprété différemment pendant une opération récursive d'une opération non récursive - Consultez les commandes mask et recurse pour davantage d'informations. Il faut également souligner que tous les transferts de smbclient sont faits en mode binaire. Voir aussi la commande lowercase.

mkdir <nom_de_répertoire> Essaye de créer un nouveau répertoire sur le serveur (selon les permissions de l'utilisateur bien sûr) avec le nom indiqué.

mput <masque> Copie tous les fichiers correspondant au masque dans le répertoire de travail courant de la machine locale vers le serveur. Notez que masque est interprété différemment pendant une opération récursive d'une opération non récursive - Consultez les commandes mask et recurse pour davantage d'informations. Il faut également souligner que tous les transferts de smbclient sont faits en mode binaire.

print <nom_de_fichier> Imprime le fichier indiqué sur la machine locale sur un service d'impression sur le serveur. Voir aussi la commande printmode.

printmode <graphics ou text> Fixe la valeur du mode d'impression pour correspondre soit à des données binaires (N.d.T. : dans ce cas, la valeur de l'argument sera « graphics », par exemple pour des informations graphiques), soit à du texte (N.d.T. : text dans ce cas). Toutes les commandes d'impression suivantes utiliseront ce mode d'impression par la suite.

prompt Active ou non la demande de confirmation pendant les commandes mget et mput. Cette option activée, l'utilisateur sera interrogé à chaque transfert pour avoir sa confirmation, dans le cas contraire, tous les fichiers seront transférés sans son accord préalable.

put <nom_de_fichier_local> [nom_de_fichier_distant] Copie le fichier appelé nom_de_fichier_local depuis la machine exécutant le client vers le serveur. Si précisé, le nom de la copie distante sera nom_de_fichier_distant. Notez que tous les transferts de smbclient sont en mode binaire. Voir aussi la commande lowercase.

queue Affiche la queue d'impression, avec le numéro du travail d'impression, son nom, sa taille et son statut.

quit Voir la commande exit.

rd <nom_de_répertoire> Voir la commande rmdir.

recurse Active la récursion à travers les répertoires pour les commandes mget et mput. Cette option activée, ces commandes s'effectueront dans tous les sous-répertoires du répertoire source (par exemple le répertoire d'où sont copiés les fichiers) correspondants au motif masque précisé. Seuls les fichiers correspondants au masque de la commande mask seront utilisés. Voir aussi la commande mask. Quand la récursion est désactivée, seuls les fichiers du répertoire courant sur la machine source correspondant au masque indiqué aux commandes mget ou mput seront copiés, et le masque spécifié par la commande mask sera ignoré.

rm <masque> Supprime tous les fichiers correspondants à mask sur le répertoire de travail courant sur le serveur.

rmdir <nom_de_répertoire> Supprime le répertoire indiqué (en tenant compte des droits d'accès de l'utilisateur) du serveur.

tar <c|x>[IXbgNa] Effectue une opération tar - voir la ligne de commande -T ci-dessus. Le comportement peut en être affecté par la commande tarmode (voir ci-dessous). Utiliser g (sauvegarde incrémentale) et N (plus récent) modifiera les réglages de tarmode. Notez que l'option « - » avec tar x peut ne pas fonctionner - utilisez la ligne de commande à la place.

blocksize <taille_des_blocs> Taille de blocs. Doit être suivie par une taille de blocs valide (supérieure à zéro). Force le fichier tar à être écrit en taille_des_blocs*TBLOCK (habituellement 512 octets) blocs.

tarmode <full|inc|reset|noreset> Change le comportement de tar par rapport aux bits d'archive. En mode complet (N.d.T. : full), tar sauvegardera tout sans se préoccuper du réglage des bits d'archive (C'est le mode par défaut). En mode incrémental (N.d.T. : incremental), tar ne sauvegardera que les fichiers avec le bit d'archive positionné. En mode réinitialisation (N.d.T. : reset), tar réinitialisera le bit d'archive de tous les fichiers qu'il sauvegardera (cela implique un partage en lecture/écriture).

setmode <nom_de_fichier> <perm=[+|-]rsha> Une version de la commande DOS attrib pour fixer les permissions. Par exemple : setmode monfichier +r positionnera monfichier en lecture seule.

Notes


Certains serveurs ont des problèmes avec la casse des noms d'utilisateur, des mots de passe, des noms de partage et de services et des noms de machine. Si vous ne parvenez pas à vous connecter, essayez de donner tous les paramètres en majuscules.

Il est parfois nécessaire d'utiliser l'option -n quand vous vous connectez sur certains types de serveurs. Par exemple, OS/2 LanManager insiste pour avoir un nom NetBIOS valide, vous aurez donc besoin de fournir un nom valide connu par le serveur.

smbclient supporte les noms de fichiers longs quand le serveur supporte le protocole LANMAN2 ou supérieur.

Variables denvironnement


La variable USER peut contenir le nom d'utilisateur de la personne utilisant le client. Cette information est utilisée uniquement si le protocole est à une version suffisamment élevée pour supporter les mots de passe de session.

La variable PASSWD peut contenir le mot de passe de la personne utilisant le client. Cette information est utilisée dans les mêmes cas que pour USER.

La variable LIBSMB_PROG peut contenir le chemin exécuté avec system() que le client doit contacter au lieu de se connecter à un serveur. Cette fonctionnalité est utilisée principalement pour le développement et fonctionne le mieux lorsque l'on utilise un fichier LMHOSTS.

Installation


L'emplacement du programme client est un problème pour certains administrateurs. Ce qui suit n'est qu'une suggestion :

Il est préconisé que le programme smbclient soit installé dans le répertoire /usr/local/samba/bin/ ou dans /usr/samba/bin/, ce répertoire doit être lisible par tous mais en accès en écriture uniquement par root. Le programme client en lui même doit être exécutable par tous mais NE DOIT PAS être setuid ou setgid !

Les fichiers de log du client doivent être mis dans un répertoire avec un accès en lecture et écriture uniquement pour l'utilisateur.

Pour tester le client, vous aurez besoin de connaître le nom d'un serveur SMB/CIFS en fonctionnement. Il est également possible de lancer smbd(8) en tant qu'utilisateur normal comme un démon sur un port accessible à n'importe quel utilisateur (habituellement un port supérieur à 1024) afin d'obtenir un serveur de test convenant tout à fait.

Diagnostiques


La plupart des diagnostics émis par le client sont enregistrés dans un fichier spécifique. Le nom de ce fichier est précisé au moment de la compilation du logiciel mais peut-être précisé en ligne de commande.

Le nombre et la nature des diagnostics disponibles dépend du niveau de déboggage utilisé par le client. Si vous rencontrez des problèmes, fixez le niveau de déboggage à 3 et consultez les fichiers de log.

Version


Cette page de manuel est correcte pour la version 2.2 de Samba.

Auteur


Le logiciel Samba originel a été conçu par Andrew Tridgell. Samba est dorénavant développé par l'équipe Samba comme un projet « Open Source » à la manière de Linux.

Les pages de manuel de Samba ont été écrites originellement par Karl Auer. Les pages de manuel ont été converties en format YODL (un autre très bon logiciel « Open Source », disponible sur ftp://ftp.icce.rug.nl/pub/unix/) et mises à jour pour la version 2.0 par Jeremy Allison. La conversion en DocBook pour Samba 2.2 a été réalisée par Gerald Carter.

Traduction

Pierre SOUCHAY < pierre.souchay@free.fr >, 2002.