列出文件

您可以显示两种类别的文件。受 Rational® Synergy 控制的对象将在 -l 命令选项中说明。仅存在于文件系统中的文件将在 -m 命令选项中说明。

ccm ls 命令列出的所有受控对象均可使用名称为 relative_path 的新伪特性。 此特性是该对象上下文项目中的相对路径,在所有平台上均使用目录字段分隔符 /。如果该对象不是指定上下文项目的成员,那么该特性在缺省情况下显示为空字符串。

关于此任务

ls 命令仅用于 UNIX 操作系统。

ccm ls -p|-project [-m] ([-l] | [-f|-format format]) [-R] [-nf|-noformat] 
        ([-ch|-column_header] | [-nch|-nocolumn_header]) 
        [-sep|-separator separator] ([-sby|-sortby sortspec] | 
        [-ns|-nosort|-no_sort]) [-gby|-groupby groupformat] project_spec...
ccm ls [-m] ([-l] | [-f|-format format]) [-R] [-nf|-noformat] 
        ([-ch|-column_header] | [-nch|-nocolumn_header]) 
        [-sep|-separator separator] ([-sby|-sortby sortspec] | 
        [-ns|-nosort|-no_sort]) [-gby|-groupby groupformat] 
        [path_or_file_spec...]
-ch|-column_header
指定要在输出格式中使用列标题。请参阅 -ch|-column_header 以获取详细信息。
-f|-format format
指定命令输出格式。请参阅 -f|-format 以获取详细信息。

关键字可以是内置关键字(%fullname%displayname%objectname)或任何现有属性的名称,例如 %modify_time%status

要查看关键字列表,请参阅Built-in keywords

-gby|-groupby groupformat
指定如何对命令输出分组。请参阅 -gby|-groupby 以获取详细信息。
-l
指定使用长缺省格式。 当未使用 -f|-format 指定用户定义的格式时,请使用此格式。
-m
显示非受控文件和目录以及受控项。 如果未使用 -f|-format 选项指定用户定义的格式,那么缺省格式(短格式或长格式)将包括指示文件同步状态的列,如下所示:
  • 本地副本 (LC)

    表示在项目中的文件,但这些文件在工作区中具有本地副本而非符号链接。

    如果文件显示有此标记,并且您的工作区基于链接,请执行 reconcile 操作。有关更多信息,请参阅 reconcile 命令

  • 未同步 (NS)

    表示在项目中但不在工作区中的文件。当您向项目添加文件而工作区不可见时,或者删除了某个文件的链接或本地副本时,将发生此情形。

    如果您工作区中的大多数文件显示有此标记,请执行 reconcile 操作。有关更多信息,请参阅 reconcile 命令

  • 非受控 (UC)

    表示在工作区中但不在项目中的文件。要查看带有 UC 标记的非受控文件,必须将 -m 选项与 -l 选项结合使用。

    在用户定义的格式中,可以使用 %Sync 关键字来显示同步状态。

    如果对象存在时间超过 6 个月,将显示年份而非时间。

-nch|-nocolumn_header
指定不要在输出格式中使用列标题。请参阅 -nch|-nocolumn_header 以获取详细信息。
-nf|-noformat
指定不要使用列对齐。请参阅 -nf|-noformat 以获取详细信息。
-ns|-nosort|-no_sort
指定不对命令输出排序。请参阅 -ns|-nosort 以获取详细信息。
path_or_file_spec
指定要列出的路径。可以将 path_or_file_spec 设置为数据库中定义的项目、目录或文件。此路径还可以是空目录条目。如果省略,将列出当前工作目录。请参阅File specification以获取详细信息。
-p|-project
显示项目的历史记录。
project_spec
指定要列出的项目。请参阅Project specification以获取详细信息。
-R
以递归方式显示子目录成员。此命令不递归到子项目。
-sby|-sortby sortspec
指定如何对命令输出排序。请参阅 -sby|-sortby 以获取详细信息。
-sep|-separator separator
只能与 -f|-format 选项一起使用。指定其他分隔符。请参阅 -sep|-separator 以获取详细信息。

示例

以长格式列出当前目录。

ccm ls -l

working john 2008-07-25 11:56 csrc 1 alias.c-4.5 27
working john 2008-07-25 11:56 csrc 1 diff.c-4.5 27
working john 2008-07-25 11:56 csrc 1 move.c-4.5 27
working john 2008-07-25 11:57 csrc 1 start.c-4.5 27


反馈