1fwblookup(1)                   Firewall Builder                   fwblookup(1)
2
3
4

NAME

6       fwblookup - General purpose object lookup tool
7

SYNOPSIS

9       fwblookup       [-aattribute]       [-rADILMNPTV]       -fdata_file.xml
10       object_id|tree_path_to_object
11
12

DESCRIPTION

14       fwblookup is a general purpose object lookup tool for Firewall  Builder
15       (see  fwbuilder(1)).  This tool finds object in the data file specified
16       with "-f" option and prints its attributes requested via  command  line
17       options.  Object  to be found is designated by its ID or full tree path
18       given as an argument on the command line. This  tool  can  be  used  in
19       scripts  that  need  to  be able to find and inspect objects in the XML
20       file, such as firewall policy installation script etc.
21
22

OPTIONS

24       -f FILE
25              Specify the name of the data file to be processed.
26
27
28       -a atribute
29              Print value of  the  XML  attribute  'attribute'.  If  specified
30              attribute  does  not  exist  in  the object, fwblookup prints an
31              error message and terminates. This is universal option that  can
32              find  and print any attribute in any object, provided it exists,
33              however you need to know full tree path to the object or its  ID
34              and  correct name of the attribute you want to print. This means
35              that detailed knowledge of Firewall Builder XML DTD is required.
36              See  below for some convenient shortcut options. This option can
37              be used only once on a command line;  if  it  is  used  multiple
38              times, then only the last attribute is printed.
39
40
41       -A     Print  an  address of the object. Since not all objects can have
42              an address, the program verifies type of the object and  returns
43              an error if the object does not have an address.
44
45
46       -D     Dump  all  the  data available for the object. If option "-r" is
47              also used, dump recursively the object and all other objects  in
48              the tree below it.
49
50
51       -I     Print object's ID.
52
53
54       -l     List  all the objects located immediately under the given object
55              in the tree (its 'children') and print their names, IDs, path or
56              type,  depending  on  the  options -N, -I, -T or -P which can be
57              used together with -l.
58
59
60       -L     Print interface label
61
62
63       -M     Print management address. Only Host  and  Firewall  objects  can
64              have management address.
65
66
67       -N     Print object's name
68
69
70       -P     Print  full  tree  path to the object, starting with a tree root
71              "FWobjectDatabase".
72
73
74       -r     Dump or list the object and all other objects in the tree  below
75              it (see "-l and -D")
76
77
78       -T     Print objects's type name.
79
80
81       -V     Print version number and quit.
82
83

URL

85       Firewall   Builder   home   page  is  located  at  the  following  URL:
86       http://www.fwbuilder.org/
87
88

BUGS

90       Please report bugs using bug tracking system on SourceForge:
91
92       http://sourceforge.net/tracker/?group_id=5314&atid=105314
93
94
95

SEE ALSO

97       fwbuilder(1), fwbedit(1),
98
99
100FWB                                                               fwblookup(1)
Impressum