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 [INFILE...]
11

DESCRIPTION

13       ksvalidator is a program that takes an input  kickstart  file  and  at‐
14       tempts  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 er‐
19       rors (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 in‐
25       stall properly, because it does not understand the complexities of par‐
26       titioning and what potentially already exists on disk.
27

EXIT STATUS

29       ksvalidator returns 0 on success, and a value equal to amount of errors
30       if some INFILEs do not exist or there are errors parsing the  kickstart
31       files.
32

OPTIONS

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

SEE ALSO

57       ksflatten (1), ksshell (1), ksverdiff (1)
58
59
60
61                                                                KSVALIDATOR(1)