fssrv.script

Software Testing Automation Framework (STAF)的开发代码

:hp2.Syntax::ehp2.  :xph.GET ENTRY C&colon.\Stuff\WhatIsIt.d TYPE:exph.
.br
:hp2.Results::ehp2.
:xmp.
F
:exmp.
:p.
:li.:hp2.Goal::ehp2. Retrieve the last modification time of the file system entry
{STAF/Config/BootDrive}\CONFIG.SYS
.br
:hp2.Syntax::ehp2.  :xph.GET ENTRY {STAF/Config/BootDrive}\CONFIG.SYS MODTIME:exph.
.br
:hp2.Results::ehp2.
:xmp.
20040512-18:07:52
:exmp.
:p.
:li.:hp2.Goal::ehp2. Retrieve the size of the file system entry /var/log/messages
.br
:hp2.Syntax::ehp2.  :xph.GET ENTRY /test1/projectX.tar SIZE:exph.
.br
:hp2.Results::ehp2. If the request is submitted from the
command line, the result, in default format, could look like:
:xmp.
Upper 32-bit Size: 0
Lower 32-bit Size: 340488704
:exmp.
:eul.
.*
.*---------------------------------------------------------------------
.*
:ih1.service commands
:ih2.QUERY
:i3.file system service
:h3.QUERY
:p.QUERY retrieves all associated attributes of a file system entry.

:h4.Syntax
:xmp.
QUERY ENTRY <Name>
:exmp.
:p.:xph.ENTRY:exph. specifies the name of the file system entry to query.
&varres.

:h4.Security
:p.&seclvl. 2.

:h4.Return Codes
:p.All return codes from QUERY are documented in :hdref refid=retcode..

:h4.Results
:p.
On successful return, the result buffer for a :xph.QUERY:exph. request
will contain a marshalled :xph.<Map&colon.STAF/Service/FS/QueryInfo>:exph.
representing information about the file system entry attributes.
The map is defined as follows:
:table cols='* * * *'.
:tcap.Definition of map class STAF/Service/FS/QueryInfo
:tnote text='Description'.This map class represents information about
a file system entry attributes.
:thd.
:c.Key Name
:c.Display Name
:c.Type
:c.Format / Value
:ethd.
:row.
:c.name
:c.Name
:c.&stringObj.
:c.
:row.
:c.type
:c.Type
:c.&stringObj.
:c.
:row.
:c.upperSize
:c.Upper 32-bit Size
:c.&stringObj.
:c.
:row.
:c.lowerSize
:c.Lower 32-bit Size
:c.&stringObj.
:c.
:row.
:c.lastModifiedTimestamp
:c.Modified Date-Time
:c.&stringObj.
:c.&timestampFormat.
:tnote text='Notes'.
The values for "Type", "Upper 32-bit Size", "Lower 32-bit Size", and
"Last Modification Time" are formatted as specified in section :hdref refid=fsgete..
:etnote.
:etable.

:h4.Examples
:p.
:ul.
:li.:hp2.Goal::ehp2. Retrieve the attributes for the file system entry
/tests/project.tar.gz
.br
:hp2.Syntax::ehp2.&nbsp; :xph.QUERY ENTRY /tests/project.tar.gz:exph.
.br
:hp2.Results::ehp2.  If the request is issued from the command line,
the result, in default format, could look like:
:xmp.
Name              : /tests/project.tar.gz
Type              : F
Upper 32-bit Size : 0
Lower 32-bit Size : 340488704
Modified Date-Time: 20040512-18:07:52
:exmp.
:eul.
.*
.*---------------------------------------------------------------------
.*
:ih1.service commands
:ih2.LIST DIRECTORY
:i3.file system service
:h3.LIST DIRECTORY
:p.LIST DIRECTORY retrieves the contents of a directory.
:h4.Syntax
:xmp.
LIST DIRECTORY <Name> &lbrk.NAME <Pattern>&rbrk. &lbrk.EXT <Pattern>&rbrk. &lbrk.TYPE <Types>&rbrk.
     &lbrk.SORTBYNAME | SORTBYSIZE | SORTBYMODTIME&rbrk.
     &lbrk.CASESENSITIVE | CASEINSENSITIVE&rbrk. &lbrk.LONG &lbrk.DETAILS&rbrk.&rbrk. &lbrk.RECURSE&rbrk.
:exmp.
:p.:xph.DIRECTORY:exph. specifies the name of the directory to list. &varres.
:p.:xph.NAME:exph. specifies a pattern used to match the name of child entries
(and child entries in its subdirectories if the :xph.RECURSE:exph. option is specified).
Only child entries whose name match this pattern will be returned.  The default
pattern is "*". &varres.
:p.:xph.EXT:exph. specifies a pattern used to match the extension of child entries.
(and child entries in its subdirectories if the :xph.RECURSE:exph. option is specified).
Only child entries whose extension match this pattern will be
returned.  The default pattern is "*". &varres.
:note.The COPY/LIST DIRECTORY commands recognize the "name" (:xph.NAME:exph.)
portion of a filename as the character(s) that preceed a period (or the entire
filename if it does not include a period) and the "extension" (:xph.EXT:exph.)
portion of a filename are character(s) that follow a period.
For example, for filename myfile.txt the "name" portion is "myfile" and
the "extension" portion is "txt".  To match filenames whose name begins
with "my" and whose extension is "txt", you could specify options
:xph.NAME my* EXT txt:exph..
:p.:xph.TYPE:exph. specifies the types of child entries to return.  These types
are the same types described in section :hdref refid=fsgete., with the addition
of '!', which, when specified along with 'D', includes the special directories
'.' and '..'.  You may also specify the string "ALL" to include all entry types.
By default, only files and non-special directories are included.  &varres.
:p.:xph.SORTBYNAME:exph. specifies that the list of child entries should be
sorted by their name.
:p.:xph.SORTBYSIZE:exph. specifies that the list of child entries should be
sorted by their size.
:p.:xph.SORTBYMODTIME:exph. specifies that the list of child entries should be
sorted by their last modification time.
:note.If none of the sorting options is used, the default is not to sort the
list.  It will be in the same order as returned by the operating system, which
is not guaranteed to perform any sorting of its own.
:p.:xph.CASESENSITIVE:exph. specifies that the patterns specified by
:xph.NAME:exph. and :xph.EXT:exph. are to be matched in a case sensitive manner.
It also affects the sorting performed by :xph.SORTBYNAME:exph..
:p.:xph.CASEINSENSITIVE:exph. specifies that the patterns specified by
:xph.NAME:exph. and :xph.EXT:exph. are to be matched in a case insensitive
manner.  It also affects the sorting performed by :xph.SORTBYNAME:exph..
:note.If neither :xph.CASESENSITIVE:exph. nor :xph.CASEINSENSITIVE:exph. is
specified, the default is determined by the operating system -- unix systems
default to :xph.CASESENSITIVE:exph., all others default to
:xph.CASEINSENSITIVE:exph..
:p.:xph.LONG:exph. specifies that the list of child entries should include their
name, type, size, and last modification time.  By default the list only includes
the name of the entry.
:p.:xph.DETAILS:exph. specifies to provide more details about the child entries.
Specifically, the upper 32-bit size and lower 32-bit size will be shown in
separate fields and the size will be shown in bytes instead of rounding the size
in kilobytes or megabytes.
:p.:xph.RECURSE:exph. specifies that any subdirectories will be recursively listed.

:h4.Security
:p.&seclvl. 2.
:h4.Return Codes
:p.All return codes from LIST DIRECTORY are documented in :hdref refid=retcode..
:h4.Results
:p.On successful return, the result buffer will contain the contents of the
specified directory as follows:
:ul.
:li.If the :xph.LONG:exph. option is not specified, the result buffer will contain
a marshalled :xph.<List> of <String>:exph. representing the names of the entries in
the specified directory.
:p.
:li.If the :xph.LONG:exph. option is specified without the :xph.DETAILS:exph.
option, the result buffer will contain a marshalled
:xph.<List> of <Map&colon.STAF/Service/FS/ListLongInfo>:exph. representing
information about each entry in the file, including name, type, size, and
date-time last modified.
The map is defined as follows:
:table cols='* * * 2*'.
:tcap.Definition of map class STAF/Service/FS/ListLongInfo
:tnote text='Description'.This map class represents information about an entry
in a specified directory.
:thd.
:c.Key Name
:c.Display Name
:c.Type
:c.Format / Value
:ethd.
:row.
:c.type
:c.Type
:c.&stringObj.
:c.
:row.
:c.size
:c.Size
:c.&stringObj.
:c.
:row.
:c.lastModifiedTimestamp
:c.Modified Date-Time
:c.&stringObj.
:c.&timestampFormat.
:row.
:c.name
:c.Name
:c.&stringObj.
:c.
:tnote text='Notes'. 
The "Size" value will only include the lower 32-bits of the size.
It will also use the extensions 'K' and 'M' to represent kilobytes and megabytes,
respectively.
:etnote.
:etable.
:p.
:li.If the :xph.LONG:exph. and :xph.DETAILS:exph. options are specified,
the result buffer will contain a marshalled
:xph.<List> of <Map&colon.STAF/Service/FS/ListDetailsInfo>:exph. representing
detailed information about each entry in the file, including name, type, size,
and date-time last modified.
The map is defined as follows:
:table cols='* * * 2*'.
:tcap.Definition of map class STAF/Service/FS/ListDetailsInfo
:tnote text='Description'.This map class represents detailed information about
an entry in a specified directory.
:thd.
:c.Key Name
:c.Display Name
:c.Type
:c.Format / Value
:ethd.
:row.
:c.name
:c.Name
:c.&stringObj.
:c.
:row.
:c.type
:c.Type
:c.&stringObj.
:c.
:row.
:c.upperSize
:c.U-Size
:c.&stringObj.
:c.
:row.
:c.lowerSize
:c.L-Size
:c.&stringObj.
:c.
:row.
:c.lastModifiedTimestamp
:c.Modified Date-Time
:c.&stringObj.
:c.&timestampFormat.
:tnote text='Notes'. 
The "U-Size" value is the upper 32-bits of the size and the "L-Size" value is
the lower 32-bits of the size.  The sizes are shown in bytes.
:etnote.
:etable.
:eul.

:h4.Examples
:p.
:ul.
:li.:hp2.Goal::ehp2. List the contents of the /tmp directory in the default format
(without specifying the LONG option).
.br
:hp2.Syntax::ehp2.&nbsp; :xph.LIST DIRECTORY /tmp:exph.
.br
:hp2.Results::ehp2. If the request is submitted from the
command line, the result, in default format, could look like the following:
:xmp.
en_platformsdk_win2003.exe
2-ltp-logfile
test1
project-docs.tar
ACME_NEW2.xml
project.htm
AutoFVT.bsh
:exmp.
:p.
:li.:hp2.Goal::ehp2. List the contents of the /tmp directory specifying to get
more information on the entries in the directory.
.br
:hp2.Syntax::ehp2.&nbsp; :xph.LIST DIRECTORY /tmp LONG:exph.
.br
:hp2.Results::ehp2. If the request is submitted from the
command line, the result, in table format, could look like the following:
:xmp.
Type Size  Modified Date-Time Name
---- ----- ------------------ --------------------------
F    324M  20040512-18:07:52  en_platformsdk_win2003.exe
F    323   20040706-16:13:10  2-ltp-logfile
D    0     20040728-11:21:44  test1
F    1210K 20040517-11:57:10  project-docs.tar
F    258K  20040412-11:49:06  ACME_NEW2.xml
F    12505 20030506-19:14:40  project.htm
F    44    20040928-16:24:40  AutoFVT.bsh:exmp.
:p.
:li.:hp2.Goal::ehp2. List the contents of the /tmp directory specifying to get
more detailed information on the entries in the directory, sorted by size.
.br
:hp2.Syntax::ehp2.&nbsp; :xph.LIST DIRECTORY /tmp LONG DETAILS SORTBYSIZE:exph.
.br
:hp2.Results::ehp2. If the request is submitted from the
command line, the result, in table format, could look like the following:
:xmp.
Name                       Type U-Size L-Size    Modified Date-Time
-------------------------- ---- ------ --------- ------------------
test1                      D    0      0         20040728-11:21:44
AutoFVT.bsh                F    0      44        20040928-16:24:40
2-ltp-logfile              F    0      323       20040706-16:13:10
project.htm                F    0      12505     20030506-19:14:40
ACME_NEW2.xml              F    0      264691    20040412-11:49:06
project-docs.tar           F    0      1239040   20040517-11:57:10
en_platformsdk_win2003.exe F    0      340488704 20040512-18:07:52
:exmp.
:p.
:li.:hp2.Goal::ehp2. List only the files in the /tmp directory.
.br
:hp2.Syntax::ehp2.&nbsp; :xph.LIST DIRECTORY /tmp LONG TYPE F SORTBYNAME:exph.
.br
:hp2.Results::ehp2. If the request is submitted from the
command line, the result, in table format, could look like the following:
:xmp.
Type Size  Modified Date-Time Name
---- ----- ------------------ --------------------------
F    323   20040706-16:13:10  2-ltp-logfile
F    258K  20040412-11:49:06  ACME_NEW2.xml
F    44    20040928-16:24:40  AutoFVT.bsh
F    324M  20040512-18:07:52  en_platformsdk_win2003.exe
F    1210K 20040517-11:57:10  project-docs.tar
F    12505 20030506-19:14:40  project.htm
:exmp.
:p.
:li.:hp2.Goal::ehp2. List all the entries in C&colon.\Projects with an 
extension of "txt".  Match this extension in a case sensitive manner.
.br
:hp2.Syntax::ehp2.&nbsp; :xph.LIST DIRECTORY C&colon.\Projects EXT txt CASESENSITIVE:exph.
.br
:hp2.Results::ehp2. If the request is submitted from the
command line, the result, in default format, could look like the following:
:xmp.
javacore.20030420.041412.7713.txt