Radmind/ktcheck

NAME

      ktcheck - verify and download command file and transcripts

SYNOPSIS

      ktcheck  [-inrV]  [  -q | -v  ]  [  -c checksum ] [ -K command-file ] [
      -h host ] [ -p port ] [ -w auth-level ] [ -x ca-pem-file ]  [  -y cert-
      pem-file ] [ -z private-key-file ]

DESCRIPTION

      ktcheck  verifies a client's command file with the radmind server host.
      The command file is downloaded from host if it is missing  or  has  the
      wrong  size.   With  the  -c  option, checksums are also used to verify
      files.

      Reading the command file line-by-line, ktcheck  verifies  each  command
      file  and  transcript listed, downloading it from host if it is missing
      or out of date.  ktcheck ignores blank lines and comments ( lines start-
      ing with '#' ).  Included command files are read are verified using the
      same method.

      Each special file listed in the command file is converted into a  tran-
      script  line  in special.T with information provided by host.  See rad-
      mind(8) for details of the STAT command.

      If checksumming is turned on, the special transcript is  verified  using
      the  checksum  and  file  size.  If either are wrong, the special tran-
      script is updated.  If checksumming is turned  off,  the  special  tran-
      script is always updated.

      Files  updated  by ktcheck must be regular files and the user must have
      access to modify them.

      When run with the -n option, ktcheck verifies but never  downloads  the
      command files or transcripts.  A tempory special.T is created for veri-
      fication and is removed on exit.

OPTIONS

      -c checksum        enables checksumming.

      -i                 force output line buffering.

      -h host            specifies the radmind server, by default radmind.

      -K command         specifies  a  command  file,  by  default  /var/rad-
                         mind/client/command.K.

      -n                 no files modified.

      -p port            specifies a port, by default 6662.

      -q                 suppress all messages.

      -r                 use  random  seed file $RANDFILE if that environment
                         variable  is   set,   $HOME/.rnd   otherwise.    See
                         RAND_load_file(3o).

      -V                 displays  the  version  of  ktcheck, a list  of sup-
                         ported checksumming algorithms in  descending  order
                         of preference and then exits.

      -v                 displays communication with the radmind server.

      -w auth-level      TLS  authorization level, by default 0.  0 = no TLS,
                         1 = server verification, 2 = server and client veri-
                         fication.

      -x ca-pem-file     Certificate   authority's   public  certificate,  by
                         default /var/radmind/cert/ca.pem.

      -y cert-pem-file   Client's public certificate,  by  default  /var/rad-
                         mind/cert/cert.pem.

      -z private-key-file
                         Client's   private   key,   by   default   /var/rad-
                         mind/cert/cert.pem.

FILES

      /var/radmind/client/command.K
                         name of the default command file.

      special.T          name of the special transcript.

EXIT STATUS

      The following exit values are returned:

      0    No differences were found.

      1    Differences were found.

      >1   An error occurred.

SEE ALSO

      fsdiff(1),  lapply(1),  lcksum(1),  lcreate(1),  lfdiff(1),  lmerge(1),
      twhich(1), radmind(8), RAND_load_file(3o).