1
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
2
<html xmlns="http://www.w3.org/1999/xhtml">
3
<!-- Documenting T:NAnt.Compression.Types.TarFileSet-->
5
<meta http-equiv="Content-Language" content="en-ca" />
6
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
7
<link rel="stylesheet" type="text/css" href="../style.css" />
8
<title><tarfileset> Type</title>
11
<table width="100%" border="0" cellspacing="0" cellpadding="2" class="NavBar">
13
<td class="NavBar-Cell">
14
<a href="http://nant.sourceforge.net">
17
<img alt="->" src="../images/arrow.gif" />
18
<a href="../index.html">Help</a>
19
<img alt="->" src="../images/arrow.gif" />
20
<a href="../types/index.html">Type Reference</a>
21
<img alt="->" src="../images/arrow.gif" /> <tarfileset></td>
22
<td class="NavBar-Cell" align="right">
26
<h1><tarfileset></h1>
27
<p> A <a href="../types/tarfileset.html"><tarfileset></a> is a <a href="../types/fileset.html"><fileset></a> with extra attributes useful in the context of the <a href="../tasks/tar.html"><tar></a> task. </p>
33
<th style="text-align: center;">Type</th>
35
<th style="text-align: center;">Required</th>
38
<td valign="top">dirmode</td>
39
<td style="text-align: center;">int</td>
40
<td> A 3 digit octal string, specify the user, group and other modes in the standard Unix fashion. Only applies to directories. The default is <code>755</code>. </td>
41
<td style="text-align: center;">False</td>
44
<td valign="top">filemode</td>
45
<td style="text-align: center;">int</td>
46
<td> A 3 digit octal string, specify the user, group and other modes in the standard Unix fashion. Only applies to plain files. The default is <code>644</code>. </td>
47
<td style="text-align: center;">False</td>
50
<td valign="top">gid</td>
51
<td style="text-align: center;">int</td>
52
<td> The group identifier (GID) for the tar entry. </td>
53
<td style="text-align: center;">False</td>
56
<td valign="top">groupname</td>
57
<td style="text-align: center;">string</td>
58
<td> The groupname for the tar entry. </td>
59
<td style="text-align: center;">False</td>
62
<td valign="top">prefix</td>
63
<td style="text-align: center;">string</td>
64
<td> The top level directory prefix. If set, all file and directory paths in the fileset will have this value prepended. Can either be a single directory name or a "/" separated path. </td>
65
<td style="text-align: center;">False</td>
68
<td valign="top">uid</td>
69
<td style="text-align: center;">int</td>
70
<td> The user identifier (UID) for the tar entry. </td>
71
<td style="text-align: center;">False</td>
74
<td valign="top">username</td>
75
<td style="text-align: center;">string</td>
76
<td> The username for the tar entry. </td>
77
<td style="text-align: center;">False</td>
80
<td valign="top">basedir</td>
81
<td style="text-align: center;">directory</td>
82
<td> The base of the directory of this fileset. The default is the project base directory. </td>
83
<td style="text-align: center;">False</td>
86
<td valign="top">casesensitive</td>
87
<td style="text-align: center;">bool</td>
88
<td> Indicates whether include and exclude patterns must be treated in a case-sensitive way. The default is <b>true</b> on Unix; otherwise, <b>false</b>. </td>
89
<td style="text-align: center;">False</td>
92
<td valign="top">defaultexcludes</td>
93
<td style="text-align: center;">bool</td>
94
<td> Indicates whether default excludes should be used or not. The default is <b>true</b>. </td>
95
<td style="text-align: center;">False</td>
98
<td valign="top">failonempty</td>
99
<td style="text-align: center;">bool</td>
100
<td> When set to <b>true</b>, causes the fileset element to throw a <a href="../../sdk/NAnt.Core.ValidationException.html">ValidationException</a> when no files match the includes and excludes criteria. The default is <b>false</b>. </td>
101
<td style="text-align: center;">False</td>
104
<td valign="top">id</td>
105
<td style="text-align: center;">string</td>
106
<td> The ID used to be referenced later. </td>
107
<td style="text-align: center;">False</td>
110
<td valign="top">refid</td>
111
<td style="text-align: center;">string</td>
112
<td> The ID to use as the reference. </td>
113
<td style="text-align: center;">False</td>
117
<h3>Nested Elements:</h3>
119
<!--NestedElementArray=T:NAnt.Core.Types.FileSet.Include-->
125
<div class="nested-element">
126
<i>Deprecated.</i> The items to include in the fileset. <p></p><h3>Parameters</h3><div class="table"><table><tr><th>Attribute</th><th style="text-align: center;">Type</th><th>Description</th><th style="text-align: center;">Required</th></tr><tr><td valign="top" class="required">name</td><td style="text-align: center;">string</td><td> The pattern or file name to include. </td><td style="text-align: center;">True</td></tr><tr><td valign="top">asis</td><td style="text-align: center;">bool</td><td> If <b>true</b> then the file name will be added to the <a href="../types/fileset.html"><fileset></a> without pattern matching or checking if the file exists. The default is <b>false</b>. </td><td style="text-align: center;">False</td></tr><tr><td valign="top">frompath</td><td style="text-align: center;">bool</td><td> If <b>true</b> then the file will be searched for on the path. The default is <b>false</b>. </td><td style="text-align: center;">False</td></tr><tr><td valign="top">if</td><td style="text-align: center;">bool</td><td> If <b>true</b> then the pattern will be included; otherwise, skipped. The default is <b>true</b>. </td><td style="text-align: center;">False</td></tr><tr><td valign="top">unless</td><td style="text-align: center;">bool</td><td> Opposite of <code>if</code>. If <b>false</b> then the pattern will be included; otherwise, skipped. The default is <b>false</b>. </td><td style="text-align: center;">False</td></tr></table></div></div>
133
<!--NestedElementArray=T:NAnt.Core.Types.FileSet.Include-->
139
<div class="nested-element"> The items to include in the fileset. <p></p><h3>Parameters</h3><div class="table"><table><tr><th>Attribute</th><th style="text-align: center;">Type</th><th>Description</th><th style="text-align: center;">Required</th></tr><tr><td valign="top" class="required">name</td><td style="text-align: center;">string</td><td> The pattern or file name to include. </td><td style="text-align: center;">True</td></tr><tr><td valign="top">asis</td><td style="text-align: center;">bool</td><td> If <b>true</b> then the file name will be added to the <a href="../types/fileset.html"><fileset></a> without pattern matching or checking if the file exists. The default is <b>false</b>. </td><td style="text-align: center;">False</td></tr><tr><td valign="top">frompath</td><td style="text-align: center;">bool</td><td> If <b>true</b> then the file will be searched for on the path. The default is <b>false</b>. </td><td style="text-align: center;">False</td></tr><tr><td valign="top">if</td><td style="text-align: center;">bool</td><td> If <b>true</b> then the pattern will be included; otherwise, skipped. The default is <b>true</b>. </td><td style="text-align: center;">False</td></tr><tr><td valign="top">unless</td><td style="text-align: center;">bool</td><td> Opposite of <code>if</code>. If <b>false</b> then the pattern will be included; otherwise, skipped. The default is <b>false</b>. </td><td style="text-align: center;">False</td></tr></table></div></div>
146
<!--NestedElementArray=T:NAnt.Core.Types.FileSet.Exclude-->
152
<div class="nested-element">
153
<i>Deprecated.</i> The items to exclude from the fileset. <p></p><h3>Parameters</h3><div class="table"><table><tr><th>Attribute</th><th style="text-align: center;">Type</th><th>Description</th><th style="text-align: center;">Required</th></tr><tr><td valign="top" class="required">name</td><td style="text-align: center;">string</td><td> The pattern or file name to exclude. </td><td style="text-align: center;">True</td></tr><tr><td valign="top">if</td><td style="text-align: center;">bool</td><td> If <b>true</b> then the pattern will be excluded; otherwise, skipped. The default is <b>true</b>. </td><td style="text-align: center;">False</td></tr><tr><td valign="top">unless</td><td style="text-align: center;">bool</td><td> Opposite of <code>if</code>. If <b>false</b> then the pattern will be excluded; otherwise, skipped. The default is <b>false</b>. </td><td style="text-align: center;">False</td></tr></table></div></div>
160
<!--NestedElementArray=T:NAnt.Core.Types.FileSet.Exclude-->
166
<div class="nested-element"> The items to exclude from the fileset. <p></p><h3>Parameters</h3><div class="table"><table><tr><th>Attribute</th><th style="text-align: center;">Type</th><th>Description</th><th style="text-align: center;">Required</th></tr><tr><td valign="top" class="required">name</td><td style="text-align: center;">string</td><td> The pattern or file name to exclude. </td><td style="text-align: center;">True</td></tr><tr><td valign="top">if</td><td style="text-align: center;">bool</td><td> If <b>true</b> then the pattern will be excluded; otherwise, skipped. The default is <b>true</b>. </td><td style="text-align: center;">False</td></tr><tr><td valign="top">unless</td><td style="text-align: center;">bool</td><td> Opposite of <code>if</code>. If <b>false</b> then the pattern will be excluded; otherwise, skipped. The default is <b>false</b>. </td><td style="text-align: center;">False</td></tr></table></div></div>
173
<!--NestedElementArray=T:NAnt.Core.Types.FileSet.IncludesFile-->
175
<a id="includesList">
179
<div class="nested-element">
180
<i>Deprecated.</i> The files from which a list of patterns or files to include should be obtained. <p></p><h3>Parameters</h3><div class="table"><table><tr><th>Attribute</th><th style="text-align: center;">Type</th><th>Description</th><th style="text-align: center;">Required</th></tr><tr><td valign="top">asis</td><td style="text-align: center;">bool</td><td> If <b>true</b> then the patterns in the include file will be added to the <a href="../types/fileset.html"><fileset></a> without pattern matching or checking if the file exists. The default is <b>false</b>. </td><td style="text-align: center;">False</td></tr><tr><td valign="top">frompath</td><td style="text-align: center;">bool</td><td> If <b>true</b> then the patterns in the include file will be searched for on the path. The default is <b>false</b>. </td><td style="text-align: center;">False</td></tr><tr><td valign="top">if</td><td style="text-align: center;">bool</td><td> If <b>true</b> then the patterns will be included; otherwise, skipped. The default is <b>true</b>. </td><td style="text-align: center;">False</td></tr><tr><td valign="top">unless</td><td style="text-align: center;">bool</td><td> Opposite of <code>if</code>. If <b>false</b> then the patterns will be included; otherwise, skipped. The default is <b>false</b>. </td><td style="text-align: center;">False</td></tr><tr><td valign="top" class="required">name</td><td style="text-align: center;">file</td><td> The name of a file; each line of this file is taken to be a pattern. </td><td style="text-align: center;">True</td></tr></table></div></div>
182
<a id="includesList">
184
</includesList>
187
<!--NestedElementArray=T:NAnt.Core.Types.FileSet.IncludesFile-->
189
<a id="includesfile">
193
<div class="nested-element"> The files from which a list of patterns or files to include should be obtained. <p></p><h3>Parameters</h3><div class="table"><table><tr><th>Attribute</th><th style="text-align: center;">Type</th><th>Description</th><th style="text-align: center;">Required</th></tr><tr><td valign="top">asis</td><td style="text-align: center;">bool</td><td> If <b>true</b> then the patterns in the include file will be added to the <a href="../types/fileset.html"><fileset></a> without pattern matching or checking if the file exists. The default is <b>false</b>. </td><td style="text-align: center;">False</td></tr><tr><td valign="top">frompath</td><td style="text-align: center;">bool</td><td> If <b>true</b> then the patterns in the include file will be searched for on the path. The default is <b>false</b>. </td><td style="text-align: center;">False</td></tr><tr><td valign="top">if</td><td style="text-align: center;">bool</td><td> If <b>true</b> then the patterns will be included; otherwise, skipped. The default is <b>true</b>. </td><td style="text-align: center;">False</td></tr><tr><td valign="top">unless</td><td style="text-align: center;">bool</td><td> Opposite of <code>if</code>. If <b>false</b> then the patterns will be included; otherwise, skipped. The default is <b>false</b>. </td><td style="text-align: center;">False</td></tr><tr><td valign="top" class="required">name</td><td style="text-align: center;">file</td><td> The name of a file; each line of this file is taken to be a pattern. </td><td style="text-align: center;">True</td></tr></table></div></div>
195
<a id="includesfile">
197
</includesfile>
200
<!--NestedElementArray=T:NAnt.Core.Types.FileSet.ExcludesFile-->
202
<a id="excludesfile">
206
<div class="nested-element"> The files from which a list of patterns or files to exclude should be obtained. <p></p><h3>Parameters</h3><div class="table"><table><tr><th>Attribute</th><th style="text-align: center;">Type</th><th>Description</th><th style="text-align: center;">Required</th></tr><tr><td valign="top" class="required">name</td><td style="text-align: center;">file</td><td> The name of a file; each line of this file is taken to be a pattern. </td><td style="text-align: center;">True</td></tr><tr><td valign="top">if</td><td style="text-align: center;">bool</td><td> If <b>true</b> then the patterns will be excluded; otherwise, skipped. The default is <b>true</b>. </td><td style="text-align: center;">False</td></tr><tr><td valign="top">unless</td><td style="text-align: center;">bool</td><td> Opposite of <code>if</code>. If <b>false</b> then the patterns will be excluded; otherwise, skipped. The default is <b>false</b>. </td><td style="text-align: center;">False</td></tr></table></div></div>
208
<a id="excludesfile">
210
</excludesfile>
216
<<a href="../types/patternset.html">patternset</a>>
218
<div class="nested-element"> Adds a nested set of patterns, or references a standalone patternset. <p /></div>
222
</<a href="../types/patternset.html">patternset</a>>
224
<h3>Requirements</h3>
225
<div style="margin-left: 20px;">
226
<b>Assembly:</b> NAnt.CompressionTasks (0.90.3780.0)
b'\\ No newline at end of file'