Class ExcludeDirectories

  action.Action --+            
                  |            
action.RecipeAction --+        
                      |        
      policy.BasePolicy --+    
                          |    
              policy.Policy --+
                              |
                             ExcludeDirectories

Known Subclasses:

infopolicy.ExcludeDirectories

NAME

SYNOPSIS

DESCRIPTION

The r.ExcludeDirectories policy causes directories to be excluded from the package by default. Use r.ExcludeDirectories(exceptions=filterexp) to set exceptions to this policy, which will cause directories matching the regular expression filterexp to be included in the package. Remember that Conary packages cannot share files, including directories, so only one package installed on a system at any one time can own the same directory.

There are only three reasons to explicitly package a directory: the directory needs permissions other than 0755, it needs non-root owner or group, or it must exist even if it is empty.

Therefore, it should generally not be necessary to invoke this policy directly. If your directory requires permissions other than 0755, simply use r.SetMode to specify the permissions, and the directory will be automatically included. Similarly, if you wish to include an empty directory with owner or group information, call r.Ownership on that empty directory,

Because r.Ownership can reasonably be called on an entire subdirectory tree and indiscriminately applied to files and directories alike, non-empty directories with owner or group set will be excluded from packaging unless an exception is explicitly provided.

If you call r.Ownership with a filter that applies to an empty directory, but you do not want to package that directory, you will have to remove the directory with r.Remove.

EXAMPLES

r.ExcludeDirectories(exceptions='/tftpboot')