filedist.block

Package: WA2L/edrc 1.5.57
Section: Configuration Files (4)
Updated: 17 June 2008
Index Return to Main Contents

 

NAME

filedist.block - configuration file for filedist

 

SYNOPSIS

edrc/etc/filedist.block

 

AVAILABILITY

WA2L/edrc

 

DESCRIPTION

This is the configuration file to block files from distribution using the filedist command.

 

FILEFORMAT

The fileformat is a list of rules that have the format

mode:source_host:destination_host:file

The mode field specifies if a rule is to allow or block a file being distributed from a source- to a destination host.

The fields source_host, destination_host and file are regular expressions.

The rules are processed in the sequence listed. If a rule matches, the remaining rules are not processed any more.

The last rule that is processed by filedist is always


  block:.*:.*:.*


if no previous rule matched. Therefore if you like to allow all distributions except the defined blocked files, the rule

  allow:.*:.*:.*


has to be added as the very last rule in the etc/filedist.block file.

Regular expression hints:

.*

Everything. This can be used to specify all hosts or all files.

dcdbsi5[1-3]

Range. This example defines the hosts dcdbsi51, dcdbsi52 and dcdbsi53.


See also EXAMPLES section.

 

OPTIONS

mode
mode to define the rules what files can be distributed:

allow

if the rule definition of source_host, destination_host and file matches, the file is allowed to be distributed.

block

if the rule definition of source_host, destination_host and file matches, the file is blocked from distribution.

source_host
Regular expression of the source host. The source host to be dealt with is as it is resolved by the hostname(1) command.

destination_host
Regular expression of the source host. The destination host to be dealt with is as it is specified in the interactive "Target hosts:" query of the filedist command. When specifying the destination_host take also into account, that the user could specify aliases for distribution targets or use a full qualified name. In most cases it wouldn't be needed to specify all aliases due to the provided default targets that should lead the user into the right direction.

file
Regular expression of the file to be distributed.

 

EXAMPLES

1) block rule example

This definition helps, that only files in the directories /opt/edrc, the installation directory of WA2L/edrc, and /tmp are allowed to be distributed from and to dcdbsi50.

This example has the background, that the host dcdbsi50 is a Sun Solaris system and all other hosts are HP-UX systems. To avoid miss-configuration of the systems by distributing operating system files that might have a different format on either one of the two operating systems, only a very reduced set of files is allowed to be distributed.

The last rule in this example ensures, that between all other systems all files are allowed to be distributed.

#
# filedist.block - filedist configuration file to block
#                  (prevent) files from distribution
#
# [00] 11.08.2003 CWa   Initial Version
#


#
# Fileformat:
#
#  <mode>:<source_host>:<destination_host>:<file>
#
#  Fields:
#         <mode>      = allow or block
#         <source_host>, <destination_host> and <file>
#                       are regular expressions
#
#  Hints: 
#         all hosts   = .*
#         all files   = .*
#         range       = dcdbsi5[1-2]
#


# RULES:
#
#  The rules are processed in the sequence listed.
#  If a rule matches, the remaining rules are not
#  processed any more.
#


# allow only /opt/edrc/* and /tmp/* files to be
# distributed from and to dcdbsi50.
#
allow:.*:.*:/opt/edrc/.*
allow:.*:.*:/tmp/.*
block:.*:dcdbsi50:.*
block:dcdbsi50:.*:.*


# last rule, allow all distributions, when no
# previous rule matched.
#
allow:.*:.*:.*

 

SEE ALSO

edrcintro(1), filedist(1), hostlist(3), regexintro(4)

 

NOTES

The destination_host regular expression is checked against the interactive user input. If the user specifies a host alias, the destination_host regular expression might not match and the file is distributed even if it was intended to be blocked.

 

BUGS

-

 

AUTHOR

filedist.block was developed by Christian Walther. Send suggestions and bug reports to wa2l@users.sourceforge.net .

 

COPYRIGHT

Copyright © 2008 Christian Walther

This is free software; see edrc/doc/COPYING for copying conditions. There is ABSOLUTELY NO WARRANTY; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.


 

Index

NAME
SYNOPSIS
AVAILABILITY
DESCRIPTION
FILEFORMAT
OPTIONS
EXAMPLES
SEE ALSO
NOTES
BUGS
AUTHOR
COPYRIGHT

This document was created by man2html using the manual pages.
Time: 00:14:03 GMT, March 08, 2025