golang-petname.1 1.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051
  1. .TH golang-petname 1 "15 December 2014" golang-petname "golang-petname"
  2. .SH NAME
  3. golang-petname \- utility to generate "pet names", consisting of a random combination of adverbs, an adjective, and a proper name
  4. .SH SYNOPSIS
  5. \fBgolang-petname\fP [-w|--words INT] [-s|--separator STR]
  6. .SH OPTIONS
  7. --words number of words in the name, default is 2
  8. --separator string used to separate name words, default is '-'
  9. .SH DESCRIPTION
  10. This utility will generate "pet names", consisting of a random combination of an adverb, adjective, and proper name. These are useful for unique hostnames, for instance.
  11. The default packaging contains about 2000 names, 1300 adjectives, and 4000 adverbs, yielding nearly 10 billion unique combinations, covering over 32 bits of unique namespace.
  12. As such, PetName tries to follow the tenets of Zooko's triangle. Names are:
  13. - human meaningful
  14. - decentralized
  15. - secure
  16. .SH EXAMPLES
  17. $ golang-petname
  18. wiggly-Anna
  19. $ golang-petname --words 1
  20. Marco
  21. $ golang-petname --words 3
  22. quickly-scornful-Johnathan
  23. $ golang-petname --words 4
  24. dolorously-leisurely-wee-Susan
  25. $ golang-petname --separator ":"
  26. hospitable:Isla
  27. $ golang-petname --separator "" --words 3
  28. adeptlystaticNicole
  29. .SH SEE ALSO
  30. \fIpetname\fP(1)
  31. .SH AUTHOR
  32. This manpage and the utility were written by Dustin Kirkland <dustin.kirkland@gmail.com> for Ubuntu systems (but may be used by others). Permission is granted to copy, distribute and/or modify this document and the utility under the terms of the Apache2 License.
  33. The complete text of the Apache2 License can be found in \fI/usr/share/common-licenses/Apache-2.0\fP on Debian/Ubuntu systems.