1KSVALIDATOR(1)              General Commands Manual             KSVALIDATOR(1)
2
3
4

NAME

6       ksvalidator — verify the syntax of a kickstart file
7

SYNOPSIS

9       ksvalidator  [-e  |  --firsterror]   [-i  |  --followincludes]   [-l  |
10       --listversions]  [-v | --version VERSION]  INFILE
11

DESCRIPTION

13       ksvalidator is a  program  that  takes  an  input  kickstart  file  and
14       attempts  to  verify  that  it is syntactically correct.  This includes
15       checking basics like proper quoting and making  sure  required  options
16       have  values, and more advanced checks like verifying the file does not
17       include deprecated or removed kickstart commands.   Mutually  exclusive
18       options  can  also  be  caught,  as can certain classes of partitioning
19       errors (like using the same device name multiple times).
20
21       ksvalidator does have its limitations.  It cannot run validate the syn‐
22       tax  of  %pre,  %pre-install, and %post scripts, nor does it attempt to
23       run them.  It cannot check that the %packages section is  valid.   Most
24       importantly,  it  cannot  guarantee  that  an input kickstart file will
25       install properly, because it does not understand  the  complexities  of
26       partitioning and what potentially already exists on disk.
27

EXIT STATUS

29       ksvalidator  returns  0  on  success, and 1 if INFILE does not exist or
30       there is an error parsing the kickstart file.
31

OPTIONS

33       -e, --firsterror
34                 Stop on the first warning or error.  By default,  ksvalidator
35                 will  attempt to process the entire file, potentially raising
36                 multiple errors.
37
38       -i, --followincludes
39                 Process included files in the input file when they are  seen,
40                 like  anaconda  would.   If  the included file does not exist
41                 (this can happen for a variety of reasons, but the most  com‐
42                 mon  being a %pre script that generates an included file) and
43                 this option is given, an error will be generated and process‐
44                 ing halted.
45
46       -l, --listversions
47                 List  all versions of kickstart syntax supported by ksvalida‐
48                 tor.  This is useful for determining what values can  be  fed
49                 back in on a second run.
50
51       -v, --version VERSION
52                 Use  this  version  of  kickstart  syntax when processing the
53                 file, or the latest if no version is given.
54

SEE ALSO

56       ksflatten (1), ksverdiff (1)
57
58
59
60                                                                KSVALIDATOR(1)