list, ls

Objectif

La sous-commande scm list affiche la liste des objets, parmi lesquels les zones de projet, les zones d'équipe, les flux, les espaces de travail, les fichiers et les contributeurs (utilisateurs) dans le référentiel indiqué. L'alias de cette commande est scm ls.

Synopsis

• Pour exécuter la commande scm list après avoir utilisé scm login pour créer des données d'identification stockées :

  scm list [ -r  |  --repository-uri ] URI ou pseudonyme du référentiel { [ -c  |  --contrib ] nom [ -v  |  --verbose ] --depth niveaux} type d'objet {options propres au type d'objet}

• Pour exécuter scm list en fournissant les données d'identification sur la ligne de commande :

  scm list [ -r  |  --repository-uri ] URI du référentiel [ -u  |  --username ] ID utilisateur dans le référentiel [ -P  |  --password ] mot de passe correspondant à l'ID utilisateur dans le référentiel { [ -c  |  --contrib ] nom [ -v  |  --verbose ] --depth niveaux }  type d'objet {options propres au type d'objet}

Options et arguments

[ -c  |  --contrib ] nom

ID utilisateur valide contenu dans le référentiel indiqué. Si cette option est fournie, la liste des paramètres item type est limitée aux éléments appartenant au contributeur indiqué. Si elle est omise,nom correspond par défaut à l'ID utilisateur de celui qui exécute la commande scm list. Ne s'applique pas lors de l'affichage de la liste des zones de projet, des contributeurs, des composants et des fichiers distants.

--depth niveaux

Lors de l'affichage de la liste des fichiers distants, niveaux indique la profondeur de récursivité maximale. En l'absence de valeur, niveau prend par défaut la valeur 3, ce qui affiche les trois premiers niveaux de contenu des dossiers dans le composant spécifié. En spécifiant niveaux à la valeur –, affiche la liste de tous les fichiers distants contenus dans le composant indiqué. Ne s'applique pas à d'autres types d'objet.

[ -P  |  --password ] mot de passe correspondant à l'ID utilisateur dans le référentiel

Mot de passe correspondant à l'ID utilisateur indiqué dans le référentiel nommé. Si cette option n'est pas incluse sur la ligne de commande, vous êtes invité à fournir un mot de passe. Si vous avez spécifié l'URI ou le pseudonyme d'un référentiel pour lequel vous avez stocké des données d'identification par le biais de la commande scm login, cette option est ignorée.

[ -r  |  --repository-uri ] URI du référentiel

Indique le référentiel dans lequel cette action doit être exécutée. Si vous avez stocké des données d'identification de référentiel à l'aide de la commande scm login, vous pouvez utiliser le pseudonyme que vous avez fourni pour celles-ci.

[ -u  |  --username ] ID utilisateur dans le référentiel

Spécifie un ID utilisateur qui existe déjà dans le réferentiel nommé. Si vous avez spécifié l'URI ou le pseudonyme d'un référentiel pour lequel vous avez stocké des données d'identification par le biais de la commande scm login, cette option est ignorée.

[ -v  |  --verbose ]

Fournit des messages d'information supplémentaires au cours de l'exploitation. Lors de l'affichage de la liste des composants, affiche également les versions de référence.

type d'objet

Type d'objet à répertorier. Correspond à l'un des éléments suivants :

components (composants)

Affiche la liste de tous les composants auxquels le contributeur indiqué a accès.

contributors (contributeurs)

Affiche la liste des ID utilisateur de tous les contributeurs qui possèdent des comptes dans le référentiel spécifié.

project-areas (zones de projet)

Affiche la liste de toutes les zones de projet contenues dans le référentiel.

streams (flux)

Affiche la liste des flux contenus dans toutes les zones d'équipe dont fait partie le contributeur indiqué.

remotefiles (fichiers distants)

Affiche la liste des fichiers distants contenus dans un espace de travail, composant ou projet. Les options propres à ce type d'objet sont les suivantes :

composant de l'espace de travail

Nom d'un espace de travail et d'un composant contenu dans cet espace de travail. Séparez les noms par un espace. Le composant nommé doit exister dans l'espace de travail nommé.

chemin_d'accès_distant

Nom de chemin d'accès au sein du composant indiqué. Cette option est facultative. Elle permet de restreindre la liste des chemins d'accès distants pour un composant.

team-areas (zones d'équipe)

Affiche la liste de toutes les zones d'équipe dont fait partie le contributeur indiqué.

workspaces (espaces de travail)

Affiche la liste de tous les espaces de travail appartenant au contributeur indiqué.

Exemples