list, ls

Účel

Podpříkaz scm list vypíše objekty, včetně oblastí projektu, oblastí týmu, proudů, pracovních prostorů, souborů a přispěvatelů (uživatelů) v zadaném úložišti. Alias podpříkazu scm list je scm ls.

Stručný přehled

• Spuštění podpříkazu scm list po použití podpříkazu scm login k vytvoření uloženého pověření:

  scm list [ -r  |  --repository-uri ] identifikátor URI nebo přezdívka úložiště { [ -c  |  --contrib ] název [ -v  |  --verbose ] --depth úrovně} typ objektu {volby specifické pro typ objektu}

• Spuštění podpříkazu scm list s dodáním pověření v příkazovém řádku:

  scm list [ -r  |  --repository-uri ] identifikátor URI úložiště [ -u  |  --username ] ID uživatele v úložišti [ -P  |  --password ] heslo pro ID uživatele v úložišti { [ -c  |  --contrib ] název [ -v  |  --verbose ] --depth úrovně }  typ objektu {volby specifické pro typ objektu}

Volby a argumenty

[ -c  |  --contrib ] název

ID uživatele platné v zadaném úložišti. Pokud je tato volba uvedená, je seznam typů položek omezen na položky, které vlastní zadaný přispěvatel. Pokud je tato volba vynechaná, pro parametr název se standardně použije ID uživatele, který spustí podpříkaz scm list. Nelze použít při vypisování oblastí projektu, přispěvatelů, komponent a vzdálených souborů.

--depth úrovně

Při vypisování vzdálených souborů určuje parametr úrovně maximální hloubku rekurze. Pokud není uveden, pro parametr úrovně se standardně použije hodnota 3. To znamená, že se vypíšou první tři úrovně obsahu složek v zadané komponentě. Když je jako parametr úrovně zadán znak –, vypíší se všechny vzdálené soubory v zadané komponentě. Nelze použít pro jiné typy objektu.

[ -P  |  --password ] heslo pro ID uživatele v úložišti

Heslo pro zadané ID uživatele v uvedeném úložišti. Pokud tato volba není uvedena v příkazovém řádku, budete vyzváni k zadání hesla. Pokud jste zadali identifikátor URI nebo přezdívku, pro kterou jste uložili pověření pomocí příkazu scm login, bude tato volba ignorovaná.

[ -r  |  --repository-uri ] identifikátor URI úložiště

Určuje úložiště, ve kterém se má tato akce provést. Pokud jste pověření k úložišti uložili pomocí příkazu scm login, můžete použít přezdívku, kterou jste zadali pro toto uložené pověření

[ -u  |  --username ] ID uživatele v úložišti

Určuje ID uživatele existující v uvedeném úložišti. Pokud jste zadali identifikátor URI nebo přezdívku, pro kterou jste uložili pověření pomocí příkazu scm login, bude tato volba ignorovaná.

[ -v  |  --verbose ]

Poskytovat další informativní zprávy po dobu provádění operací. Při vypisování komponent zobrazit také úrovně baseline.

typ objektu

Typ položky, která se má vypsat. Jedna z možností:

components

Vypsání všech komponent, ke kterým má zadaný přispěvatel přístup.

contributors

Vypíše ID uživatele všech přispěvatelů, kteří mají účty v zadaném úložišti.

project-areas

Vypsání všech oblastí projektu v úložišti.

streams

Vypsání proudů ve všech oblastech týmu, jejichž je zadaný přispěvatel členem.

remotefiles

Vypsání vzdálených souborů v pracovním prostoru, komponentě nebo projektu. Volby specifické pro typ objektu pro tento typ objektu:

komponenta pracovního prostoru

Název pracovního prostoru a komponenty v tomto pracovním prostoru. Názvy oddělte mezerou. Uvedená komponenta musí v uvedeném pracovním prostoru existovat.

vzdálenáCesta

Název cesty v rámci zadané komponenty. Tato volba je volitelná. Používá se k omezení seznamu vzdálených cest uvedených pro komponentu.

team-areas

Vypsání všech oblastí týmu, jejichž je zadaný přispěvatel členem.

workspaces

Vypsání všech pracovních prostorů, které vlastní zadaný přispěvatel.

Příklady