列出文件

您可以列出工作区中的项目或目录对象版本的内容。缺省情况下,输出由对象列表及其按名称顺序(不区分大小写)存储在文件系统中的关联投影组成。

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

关于此任务

ccm dir -p|-project [-m] ([-w] | [-f|-format format]) [-s] [-nf|-noformat] 
        ([-ch|-column_header] | [-nch|-nocolumn_header]) 
        [-sep|-separator separator] ([-sby|-sortby sortspec] | 
        [-ns|-nosort|-no_sort]) [-gby|-groupby groupformat] project_spec...
ccm dir [-m] ([-w] | [-f|-format format]) [-s] [-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

请参阅内置关键字,以获取关键字列表。

-gby|-groupby groupformat
指定如何对命令输出分组。请参阅 -gby|-groupby 以获取详细信息。
-m
显示受控和非受控的文件和目录。 如果未用 -f|-format 选项指定用户定义的格式,那么缺省格式(短格式或长格式)将包括指示文件同步状态的列。
  • 本地副本 (LC) - 表示项目中的文件,但这些文件在工作区中具有本地副本而非符号链接。如果文件显示有此标记,并且您的工作区基于链接,请执行 reconcile 操作。 有关更多信息,请参阅 reconcile 命令
  • 未同步 (NS) - 表示在项目中但不在工作区中的文件。当您向项目添加文件,而您的工作区不可见时,将发生此情形。当删除某个文件的链接或本地副本时也会发生此情形。如果您工作区中的大多数文件显示有此标记,请执行 reconcile 操作。有关更多信息,请参阅 reconcile 命令
  • 非受控 (UC) - 表示在工作区中但不在项目中的文件。要查看带有 UC 标记的非受控文件,必须将 -m 选项与 -l 选项结合使用。在用户定义的格式中,请使用 %Sync 关键字来显示同步状态。
-nch|-nocolumn_header
指定不要在输出格式中使用列标题。请参阅 -nch|-nocolumn_header 以获取详细信息。
-nf|-noformat
指定不要使用列对齐。请参阅 -nf|-noformat 以获取详细信息。
-ns|-nosort|-no_sort
指定不对命令输出排序。请参阅 -ns|-nosort 以获取详细信息。
path_or_file_spec
指定路径列表。可以将 path_or_file_spec 设置为数据库中定义的项目、目录或文件。此路径还可以是空目录条目。如果省略,将列出当前工作目录。请参阅文件规范以获取详细信息。
-p|-project
指定列出项目。
project_spec
指定要列出的项目。请参阅项目规范以获取详细信息。
-s
以递归方式显示子目录成员。此命令不递归到子项目。
-sby|-sortby sortspec
指定如何对命令输出排序。请参阅 -sby|-sortby 以获取详细信息。
-sep|-separator separator
只能与 -f|-format 选项一起使用。指定其他分隔符。请参阅 -sep|-separator 以获取详细信息。
-u|-unnumbered
禁止对命令输出自动编号。请参阅 -u|-unnumbered 以获取详细信息。
-w
指定使用缺省短格式。此设置将显示每个对象的显示名称。

示例


反馈