NAME

       pskey - Print prescaler key

SYNOPSIS

       pskey [options] file [file] [...]  [>stdout]

DESCRIPTION

       Read  the  prescaler  section  of a .pib file and print the SHA256 digest (key) on stdout.
       The digest acts as a finger-print of the prescalers stored  within  and  may  be  used  to
       compare  prescalers  and detect changes.  Only the prescaler section is read.  The rest of
       the PIB is ignored.

       This program is part of the Qualcomm Atheros Powerline Toolkit.  See the AMP man page  for
       an overview and installation instructions.

OPTIONS

       -q     Enable quiet mode.  This suppresses the filename after prescaler keys on output.

       -v     Verbose mode.  This option has no effect at present.  None.

ARGUMENTS

       file   The  name  of  an Atheros Parameter Information Block (PIB) file.  This file is not
              modified.  By convention, PIB files have a .pib extenstion but  this  program  does
              not enforce that convention but invalid PIB files will be rejected on input.

DISCLAIMER

       PIB  file  structure  and  content  is  proprietary  to  Qualcomm  Atheros,  Ocala FL USA.
       Consequently, public information is not available.  Qualcomm Atheros reserves the right to
       modify PIB file structure or content in future firmware releases without any obligation to
       notify or compensate users of this program.

EXAMPLES

       This example prints the SHA256 digest for the prescaler section in file  v3.3.4.pib.   The
       digest  uniquely  identifies  that  particular  prescaler  set.   PIB  files with the same
       prescaler digest contain the same prescaler set.

          # pskey v3.3.4.pib
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4 v3.3.4.pib

       The next example is the same as before but does not print the  input  filename  after  the
       key.

          # pskey v3.3.4.pib -q
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4

       The  next  example  does  the same for all .pib files in the current folder.  Observe that
       several files  have  the  same  fingerprint  and  so  contain  identical  prescaler  sets.
       Prescalers  are  designed  to  satisfy EMI requirements for various applications and world
       regions.  It is critical that the correct prescalers are used.

          # pskey *.pib
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4 2008-06-25.pib
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4 v2.0.4.pib
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4 v3.0.1.pib
          9D6F711B81BEAE3DE9182ECC264C47DDD187264A2B89A162C54F3C1FDD5CE240 v3.0.4.pib
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4 v3.0.5.pib
          9D6F711B81BEAE3DE9182ECC264C47DDD187264A2B89A162C54F3C1FDD5CE240 v3.1.0.pib
          9D6F711B81BEAE3DE9182ECC264C47DDD187264A2B89A162C54F3C1FDD5CE240 v3.1.3.pib
          9D6F711B81BEAE3DE9182ECC264C47DDD187264A2B89A162C54F3C1FDD5CE240 v3.1.4.pib
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4 v3.1.6.pib
          9D6F711B81BEAE3DE9182ECC264C47DDD187264A2B89A162C54F3C1FDD5CE240 v3.1.7.pib
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4 v3.1.8.pib
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4 v3.1.9.pib
          9D6F711B81BEAE3DE9182ECC264C47DDD187264A2B89A162C54F3C1FDD5CE240 v3.2.0.pib
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4 v3.3.0.pib
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4 v3.3.1.pib
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4 v3.3.2.pib
          980444623A8B8E76121E5014B054D9D1306C06C4D7FD7E2E158D13C9B24CFDE1 v3.3.4-1.pib
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4 v3.3.4-2.pib
          649C3B280E20A78994D11048C6E2ABEB6BA5DBCBBE3BA2BDD3BA3C3CFF8EF7E4 v3.3.4-RC9.pib
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4 v3.3.4.pib

       The next example does the same as the previous one but sorts on the  digest  in  order  to
       group files by their prescaler sets.  This highlights the fact that we have four different
       prescaler sets in the group and two files are apparently different from the  others.   The
       sort program is a Linux utility and may not be available on some systems.

          # pskey *.pib | sort
          649C3B280E20A78994D11048C6E2ABEB6BA5DBCBBE3BA2BDD3BA3C3CFF8EF7E4 v3.3.4-RC9.pib
          980444623A8B8E76121E5014B054D9D1306C06C4D7FD7E2E158D13C9B24CFDE1 v3.3.4-1.pib
          9D6F711B81BEAE3DE9182ECC264C47DDD187264A2B89A162C54F3C1FDD5CE240 v3.0.4.pib
          9D6F711B81BEAE3DE9182ECC264C47DDD187264A2B89A162C54F3C1FDD5CE240 v3.1.0.pib
          9D6F711B81BEAE3DE9182ECC264C47DDD187264A2B89A162C54F3C1FDD5CE240 v3.1.3.pib
          9D6F711B81BEAE3DE9182ECC264C47DDD187264A2B89A162C54F3C1FDD5CE240 v3.1.4.pib
          9D6F711B81BEAE3DE9182ECC264C47DDD187264A2B89A162C54F3C1FDD5CE240 v3.1.7.pib
          9D6F711B81BEAE3DE9182ECC264C47DDD187264A2B89A162C54F3C1FDD5CE240 v3.2.0.pib
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4 2008-06-25.pib
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4 v2.0.4.pib
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4 v3.0.1.pib
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4 v3.0.5.pib
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4 v3.1.6.pib
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4 v3.1.8.pib
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4 v3.1.9.pib
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4 v3.3.0.pib
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4 v3.3.1.pib
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4 v3.3.2.pib
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4 v3.3.4-2.pib
          AF26B02BB5044BE70986A5C2F5705671213D63A7827928C240D131E940EF4FC4 v3.3.4.pib

DISCLAIMER

       PIB  file  structure  and  content  is  proprietary  to  Qualcomm  Atheros,  Ocala FL USA.
       Consequently, public information is not available.  Qualcomm Atheros reserves the right to
       modify PIB file structure or content in future firmware releases without any obligation to
       notify or compensate users of this program.

SEE ALSO

       psgraph(7), psin(1), psout(1)

CREDITS

        Charles Maier