FileBoolean/FileBoolean_F-L - mydefrag_jp @ ウィキ

原文:　http://www.mydefrag.com/Scripts-FileBoolean.html
更新日: 2010/12/12 (ここで取り扱っている内容の原文をコピーした日付です)

---

FileLocation

Select the items (files, directories) that are located in a specified area on the disk. The ARGUMENT specifies one of several options to choose from, the first NUMBER is the beginning of the area and the second NUMBER the end, both in LCN (Logical Cluster Number). If the first NUMBER is zero then the area begins at the beginning of the disk. If the second NUMBER is zero then the area ends at the end of the disk.

Syntax

FileLocation(ARGUMENT , NUMBER , NUMBER)

Argument

Possible values for ARGUMENT:
BeginOfFile 	Select files if the beginning of the file is inside the area.
EndOfFile 	Select files if the end of the file is inside the area.
EntireFile 	Select files that have all their data inside the area.
AnyPart 	Select files if any of their data is inside the area.
AnyCompleteFragment 	Select files if at least 1 complete fragment is inside the area.

Example

# Highlight files from the beginning of the disk up to LCN=10000.
SetFileColor(FileLocation(EntireFile,0,10000),all,255,255,255)

See also:

• FileSelect
• FileBoolean
• FileActions

---

FileName

STRINGにマッチするファイル名を持つファイルやディレクトリといったアイテムすべてを選択します。
STRINGにはワイルドカートとして*と?(ry)を含められます。

• STRINGにはスラッシュやバックスラッシュ(および\円マーク)を含めないでください。すべてのファイル名について比較しますが、このファイル名にはスラッシュなどは含まれません。
• この関数はすべてのハードリンク ファイル名を一つのアイテム(二つ名を持ち、同時に違う場所に存在するが、その実体は同じファイル)として扱います。ログファイルには最初に見つかった名前が載ります, so it may appear as if the function has selected some wrong items. この関数はソフトリンク(ジャンクション・シンボリックリンク）を追従しません。

Syntax

FileName(STRING)

Example

FileSelect
  FileName("*.mp3")
FileActions
  ....
FileEnd

See also:

• DirectoryPath
• DirectoryName
• FullPath
• FileSelect
• FileBoolean
• FileActions

---

FragmentCount

Select all the items that have a number of fragments between the minimum (first number) and the maximum (second number). If the second number is zero then the maximum is infinity.

Syntax

FragmentCount(NUMBER , NUMBER)

Example

 FileSelect
   # Select all the items that have at least 3 fragments and at most 10 fragments.
   FragmentCount(3,10)
 FileActions
   ....
 FileEnd

See also:

• FileSelect
• FileBoolean
• FileActions

---

Fragmented

Select all the items that are fragmented(yes) or not fragmented(no).

Syntax

 Fragmented(yes)
 Fragmented(no)

Example
FileSelect

 # Select all the fragmented items.
 Fragmented(yes)

FileActions

 ....

FileEnd

See also:

• FileSelect
• FileBoolean
• FileActions

---

FullPath

STRING1にマッチするフルパスを持つディレクトリをすべて選択します。また、そのディレクトリ以下でSTRING 2にマッチするすべてのディレクトリとサブディレクトリが選択されます。
STRING1/2にはワイルドカード"*" "?" (ry)が使用できます。

• ドライブレターにもマッチするようにディレクトリマスクを書いてください。　ディレクトリパスとは "c:\windows\System32"のような物のことです。ノート:　バックスラッシュは追跡しません。ただしルート(たとえば"C:\")に限りバックスラッシュを持ちます。
• "*"(star)ワイルドカードはディレクトリデリミタの"\"(backslash)もマッチします。(訳注:ちょっと自信ないです)、The "*" (star) wildcard will also match the "\" (backslash) character, so it span's directories.
• サブディレクトリにあるファイルもまた選択されます。たとえば 「FullPath("c:\Windows","*.exe")」というコマンドはWindowsフォルダの中の.exeファイルだけを選択しますが、"Windows\System32"フォルダやWindows以下のすべてのサブフォルダの.exeファイルも処理されます。
• この関数はすべてのハードリンク ファイル名を一つのアイテム(二つ名を持ち、同時に違う場所に存在するが、その実体は同じファイル)として扱います。ログファイルには最初に見つかった名前が載ります, so it may appear as if the function has selected some wrong items. この関数はソフトリンク(ジャンクション・シンボリックリンク）を追従しません。

Syntax

 FullPath(STRING1 , STRING2)

Example

 FileSelect
   // Select all *.mp3 files in all "music" folders and subfolders.
   FullPath("*\music","*.mp3")
 FileActions
   ....
 FileEnd

 // How to include files in a directory but not it's subdirectories.
 FullPath("c:\windows","*") and not (FullPath("c:\windows\*","*"))

See also:

• FileName
• DirectoryName
• DirectoryPath
• FileSelect
• FileBoolean
• FileActions

---

Hidden

Select all the items that have the "hidden" attribute set (yes) or not set (no). Hidden items are not included by Windows in an ordinary directory listing.

Syntax

 Hidden(yes)
 Hidden(no)

Example

 FileSelect
   # Select all the items that have the "hidden" attribute.
   Hidden(yes)
 FileActions
   ....
 FileEnd

See also:

• FileSelect
• FileBoolean
• FileActions

ImportListFromBootOptimize
Select the files that are listed in the "%SystemRoot%\Prefetch\Layout.ini" file. Windows XP and Vista create a list of items (files, directories, streams, etc.) that are accessed when the computer boots. MyDefrag can use that list to place the items in a zone. If used in conjunction with the * SortByImportSequence function it will place the items in the order in which they are loaded when booting.

   * If an item was already placed in a previous zone then it will not be selected and will not be moved. For example, the default Optimize scripts first place the MFT, then the directories, and then the items used when booting. The MFT and the directories are used when booting, but are not moved to the boot optimization zone because they have already been placed in a previous zone.
   * If you have a multiboot environment then the disk(s) will be optimized for the currently booted Windows.
   * Boot optimization is not limited to the volume where Windows is installed. If Windows uses items on other volumes, then those other volumes will also be boot optimized. 

Syntax

 ImportListFromBootOptimize()

Example

 # Optimize the disks for faster booting.
 FileSelect
   ImportListFromBootOptimize()
 FileActions
   SortByImportSequence(Ascending)
 FileEnd

 Changing the list
 The "layout.ini" file is a standard Unicode text file and you can look at it with for example the Windows Notepad text editor. Microsoft (and I) feel that booting is finished when the desktop is visible and all programs have been started. The "layout.ini" file therefore lists all items that are used by Windows itself and by the first 32 programs that run after booting. The list is automatically updated by Windows, look at the date/time of the file to see when it was updated last. You can force an update with the following commandline.

 Rundll32.exe advapi32.dll,ProcessIdleTasks

 The list can contain some surprising items, files that you were not expecting to be accessed while booting. For example, Windows seems to scan lot's of folders when booting, perhaps it is looking for drivers or DLL's. The folders are listed in the layout.ini file, but the contents of the folders is not. Another example is that many programs contain their icon inside the main executable program. The executable will therefore be listed, not because the program was run when booting but because Windows needed to show the icon on the desktop. The same applies for other kinds of files, for example a big movie may end up in the list because you have a media player that is started in the background that does a quick check to see if the last played file is still there. Other background programs can do similar things.

 It's possible to change the list in several ways. The easiest way is to use the standard MyDefrag scripting commands. For example, to exclude all files larger than 100 megabytes you can do this:
 # Create zone with files that are used while booting and are smaller than 100Mb.
 FileSelect
   ImportListFromBootOptimize() and Size(0,100MB)
 FileActions
   SortByImportSequence(Ascending)
 FileEnd

Another way to change the list is by making a copy of the file, editing the file, and then using the MyDefrag * ImportListFromFile fileboolean to import the file. The advantage is that you will get a MyDefrag zone that changes very little. The disadvantage is that you have to do it all over again when something changes on the computer, for example when you install a new driver.

See also:

• SortByImportSequence
• FileSelect
• FileBoolean
• FileActions

---

ImportListFromFile

Select the items (files, directories) that are listed in the listfile.

• The STRING is the full path to an item on disk.
• The listfile is a flat text file, Unicode, UTF-8, or ASCII.
• The listfile must contain a list of full paths, 1 path per text line. For example:
  • C:\WINDOWS\SYSTEM32\NTOSKRNL.EXE
  • C:\WINDOWS\SYSTEM32\PSHED.DLL
  • C:\WINDOWS\SYSTEM32\KDCOM.DLL
  • C:\WINDOWS\SYSTEM32\CLFS.SYS
• Paths that do not exist (or invalid paths) are quietly ignored.
• Folders are entities by themselves. If the listfile contains the name of a folder then only the folder will be selected, not the items in that folder or subfolders.
• If the listfile contains the name of an item that has already been processed (placed in a previous zone) then the item will not be selected (ignored).
• This is a fileboolean function and it only selects items. The FileActions will process the selected items, for example sort by name. The * SortByImportSequence fileaction will order the items in the same sequence in which they are listed in the listfile.

Syntax

ImportListFromFile(STRING)

Example

 # Select and sort items exactly how I want it.
 FileSelect
   ImportListFromFile("c:\users\jeroen\MyOptimizeList.txt")
 FileActions
   SortByImportSequence(Ascending)
 FileEnd

See also:

• SortByImportSequence
• FileSelect
• FileBoolean
• FileActions

---

ImportListFromProgramHints

Select the files that are listed in the "%SystemRoot%\Prefetch\*.pf" files.

Windows XP and Vista create a logfile for every program that is started, containing (amongst other things) a list of items (files, directories, streams, etc.) that are accessed during the first 10 seconds of program startup. The logfiles are called "hint" files and are used by the Windows prefetcher to optimize disk access. MyDefrag can analyze the hint files and create a zone that contains all the referenced files. The zone will by default be sorted so that the most used program is first in the zone, with it's files in the order in which they are accessed.

• The STRING argument specifies which hint file(s) must be imported. Default is all the files in the "%SystemRoot%\Prefetch" folder. You can specify a wildcard "*" to match any character or "?" to match a single character. If the STRING contains a backslash ("\") then it is assumed to be a full path to a folder, to be used instead of the Windows prefetch folder.
• Hint files older than 30 days are ignored (skipped).
• The zone is sorted by how often programs have been started, the most started program first. This number is one of the statistics available in the hint files. Please note that a high number of startups does not necessarily mean that a program is important to the user.
• If a file was already placed in a previous zone then it will not be selected and will not be moved. For example, the default Optimize scripts first place the MFT, then the directories, and then the items used when booting. The MFT and the directories are used when starting a program, but are not moved to the program-hints zone because they have already been placed in a previous zone.
• The hint files do not list all files that belong to a program. Only the files that are accessed during the first 10 seconds of program startup.
• Program hints are not limited to the volume where Windows is installed. If a program uses files on other volumes then those other volumes will also be optimized.
• If you have a multiboot environment then the disk(s) will be optimized for the currently booted Windows.
• The hint files change a lot. A zone based on these files therefore also changes a lot.

Syntax

 ImportListFromProgramHints(STRING)

Example

 # Optimize the disk for faster program startup.
 FileSelect
   ImportListFromProgramHints("*")
 FileActions
   SortByImportSequence(Ascending)
 FileEnd

See also:

• SortByImportSequence
• FileSelect
• FileBoolean
• FileActions

---

Largest

Select the largests items (size in bytes). The argument is the number of items to be selected.

Syntax

 Largest(NUMBER)

Example

 FileSelect
   # Select the 10 largest files on the disk.
   Largest(10)
 FileActions
   ....
 FileEnd

See also:

• Smallest
• FileSelect
• FileBoolean
• FileActions

---

LargestFragmentSize

Select all the items that have a largest fragment with a size (in bytes) between the minimum (first number) and the maximum (second number). If the second number is zero then the maximum is infinity.

Syntax

 LargestFragmentSize(NUMBER , NUMBER)

Example

 FileSelect
   # Select all the items that have a largest fragment between 100 and 1000 bytes in size.
   LargestFragmentSize(100,1000)
 FileActions
   ....
 FileEnd

See also:

• FileSelect
• FileBoolean
• FileActions

---

LastAccess

Select all the items that have a last access time between the minimum time (first parameter) and the maximum time (second parameter). If the first parameter is empty then the minimum time is the beginning of time. If the second parameter is empty then the maximum time is infinity.

   * See the *  LastAccessEnabled fileboolean to test if Windows is configured to record (update) the last access times.
   * Some improperly programmed utilities cause a change in the last access time of all items on the disk when they scan the disk. Examples are virus scanners, backup programs, text indexers.
   * On FAT volumes the resolution of the last access time is 1 day. NTFS delays updates to the last access time by up to one hour. 

Syntax
LastAccess(DATETIME , DATETIME)

Example

 FileSelect
   # Select all the items that were accessed less than 10 days ago.
   LastAccessEnabled(yes) and LastAccess(10 days ago,now)
 FileActions
   ....
 FileEnd

See also:

• LastAccessEnabled
• FileSelect
• FileBoolean
• FileActions

---

LastAccessEnabled

Select the items if Windows is configured to record (update) the last access times. This fileboolean is designed to be used together with the * LastAccess fileboolean.

Windows XP and Vista have a setting to enable/disable the recording (updating) of the last access times of files. On Vista the default setting is not to record the last access times. You can enable or disable the Windows setting from a commandline with the "fsutil" command:
See current setting: fsutil behavior query disablelastaccess
Enable recording of last access time: fsutil behavior set disablelastaccess 0
Disable recording of last access time: fsutil behavior set disablelastaccess 1

Syntax

 LastAccessEnabled(yes)
 LastAccessEnabled(no)

Example

 FileSelect
   # Select all the items that were accessed less than 10 days ago.
   LastAccessEnabled(yes) and LastAccess(10 days ago,now)
 FileActions
   ....
 FileEnd

See also:

• LastAccess
• FileSelect
• FileBoolean
• FileActions

---

LastChange

Select all the items that were changed between the minimum time (first parameter) and the maximum time (second parameter). If the first parameter is empty then the minimum time is the beginning of time. If the second parameter is empty then the maximum time is infinity.

   * The last-changed date can be older than the creation date, for example when a file was downloaded, or unpacked from an archive (such as zip or arj). 

Syntax

 LastChange(DATETIME , DATETIME)

Example

 FileSelect
   # Select all the items that were changed less than 10 days ago.
   LastChange(10 days ago,now)
 FileActions
   ....
 FileEnd

See also:

• FileSelect
• FileBoolean
• FileActions