logo

utils-std

Collection of commonly available Unix tools git clone https://anongit.hacktivis.me/git/utils-std.git/

base64.1 (1478B)

    

  1. .\" utils-std: Collection of commonly available Unix tools
  2. .\" Copyright 2017 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
  3. .\" SPDX-License-Identifier: MPL-2.0
  4. .Dd October 12, 2024
  5. .Dt BASE64 1
  6. .Os
  7. .Sh NAME
  8. .Nm base64
  9. .Nd encode/decode base64 data to standard output
  10. .Sh SYNOPSIS
  11. .Nm
  12. .Op Fl d
  13. .Op Fl w Ar wrap
  14. .Op Ar file...
  15. .Sh DESCRIPTION
  16. .Nm
  17. reads
  18. .Ar file ,
  19. encodes or decodes in base64 and writes the results into standard output.
  20. If no
  21. .Ar file
  22. is given,
  23. .Nm
  24. reads from the standard input.
  25. .Pp
  26. .\" https://todo.sr.ht/~lanodan/utils-std/5
  27. Should be noted that the terminal-driver stdin buffering
  28. can have a maximum amount of characters per line
  29. (4096 on Linux, see
  30. .Xr tcsetattr 3 Ns ).
  31. So for copy-pasting large amounts of data you should either
  32. pipe it from a command like
  33. .Xr wl-paste 1
  34. or
  35. .Xr xclip 1 ,
  36. or generate base64 data with a line length shorter
  37. than the terminal driver buffer,
  38. for example via:
  39. .Dl Cm base64 -w $(tput cols)
  40. .Sh OPTIONS
  41. .Bl -tag -width _w_wrap
  42. .It Fl d
  43. Decode input instead of encoding it.
  44. .It Fl w Ar wrap
  45. Write at most
  46. .Ar wrap
  47. characters per line instead of the default of 76 characters.
  48. If
  49. .Ar wrap
  50. is 0, then no newlines are written.
  51. .El
  52. .Sh EXIT STATUS
  53. .Ex -std
  54. .Sh SEE ALSO
  55. .Xr uuencode 1
  56. .Sh STANDARDS
  57. .Nm
  58. follows base64 as defined in RFC3548 and RFC4648.
  59. .Sh HISTORY
  60. A
  61. .Nm
  62. utility first appeared in GNU Coreutils 6.0 (2006-08-15),
  63. .Fx 4.3 ,
  64. .Nx 9
  65. .Sh AUTHORS
  66. .An Haelwenn (lanodan) Monnier Aq Mt contact+utils@hacktivis.me