POCKLINGTON(1)

πŸ’– POCKLINGTON(1) πŸ’–

okay bestie, gather round β€” this is the General Commands Manual page for pocklington, and we're gonna make primality certificates together like it's a group project where literally everyone gets an A. πŸŽ€


✨ NAME ✨

pocklington β€” generate a Pocklington primality certificate for a prime number πŸ¦‹


🌸 SYNOPSIS 🌸

pocklington [-o filename] prime
pocklington [-o filename] -next num
pocklington [-o filename] -size s
pocklington [-o filename] -proth k n
pocklington [-o filename] -lucas n
pocklington [-o filename] -mersenne n
pocklington [-o filename] -dec filename

πŸ’… DESCRIPTION πŸ’…

So basically: you hand this tool a prime number, and it tries to generate a Pocklington primality certificate for you. That's it, that's the whole vibe. πŸ’–

note the "tries" β€” it's giving best-effort, not bestie-guaranteed, okay? 😭

πŸ‘‘ OPTIONS πŸ‘‘

  • -v β€” enable verbose mode. she will talk. πŸ—£οΈ
  • -o <filename> β€” prints the proof script into the file named <filename>. if you don't pass this, the output filename is gonna depend on how you gave the prime in the first place. ✨
  • <prime> β€” a prime number. the default output filename is either prime<prime>.v or, if that's too long, Prime.v. πŸ’€ (yes, capitalized. she has range.)
  • -next <num> β€” generate a certificate for the next prime number following <num>. the default output filename works out exactly as if you'd just given that right number yourself. πŸ¦‹
  • -size <s> β€” generate a certificate for a prime number with at least <s> decimal digits. default output filename again acts as if the right number had been given. 🌸
  • -proth <k> <n> β€” generate a certificate for the Proth number k*2^n+1. default output filename, same deal: as if the right number had been handed over. πŸ”₯
  • -lucas <n> β€” generate a certificate for the Mersenne number 2^n-1 using Lucas' test. it's more efficient, she ate. πŸ’… default output filename is lucas<n>.v.
  • -mersenne <n> β€” generate a certificate for the Mersenne number 2^n-1 using Pocklington's test. default output filename is mersenne<n>.v. πŸ‘‘
  • -dec <filename> β€” generate a certificate for the number given in the file <filename>. heads up, that file should also contain a partial factorization of the predecessor. πŸ™ˆ the output filename is <filename>.v.

and that's the whole page, no cap. this icon was served up on July 15th, 2022 under the General Commands Manual banner, and honestly? slay. πŸ«ΆπŸ’œ