{
    "mode": "man",
    "parameter": "uuencode",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/uuencode/1/json",
    "generated": "2026-06-02T19:34:23Z",
    "synopsis": "uuencode [-flags] [-flag [value]] [--option-name[[=| ]value]] [<in-file>] <output-name>",
    "sections": {
        "NAME": {
            "content": "uuencode - encode a file into email friendly text\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "uuencode [-flags] [-flag [value]] [--option-name[[=| ]value]] [<in-file>] <output-name>\n\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "uuencode  is  used to create an ASCII representation of a file that can be sent over channels\nthat may otherwise corrupt the data.  Specifically, email cannot handle binary data and  will\noften even insert a character when the six character sequence \"0rom \" is seen.\n\nuuencode will read in-file if provided and otherwise read data from standard in and write the\nencoded form to standard out.  The output will begin with a header line for use  by  uudecode\ngiving  it  the  resulting suggested file output-name and access mode.  If the output-name is\nspecifically /dev/stdout, then uudecode will emit the decoded file to standard out.\n\nNote: uuencode uses buffered input and assumes that it is not hand typed  from  a  tty.   The\nconsequence is that at a tty, you may need to hit Ctl-D several times to terminate input.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "",
            "subsections": [
                {
                    "name": "-m --base64",
                    "content": "convert using base64.\n\nBy  default,  uuencode will encode using the traditional conversion.  It is slower and\nless compact than base64.  The encoded form of the file is expanded by 37% for UU  en‐\ncoding and by 35% for base64 encoding (3 bytes become 4 plus control information).\n",
                    "flag": "-m",
                    "long": "--base64"
                },
                {
                    "name": "-e --encode-file-name",
                    "content": "encode the output file name.\n\nSince  output  file  names may contain characters that are not handled well by various\ntransmission modes, you may specify that the output-name be base64  encoded  as  well.\n(Traditional uuencoding of the file name is not supported.)\n",
                    "flag": "-e",
                    "long": "--encode-file-name"
                },
                {
                    "name": "-h --help",
                    "content": "Display usage information and exit.\n\n-!, --more-help\nPass the extended usage information through a pager.\n",
                    "flag": "-h",
                    "long": "--help"
                },
                {
                    "name": "-R --save-opts",
                    "content": "Save  the  option state to cfgfile.  The default is the last configuration file listed\nin the OPTION PRESETS section, below.  The command will exit after updating the config\nfile.\n",
                    "flag": "-R",
                    "long": "--save-opts"
                },
                {
                    "name": "-r --load-opts --no-load-opts",
                    "content": "Load  options from cfgfile.  The no-load-opts form will disable the loading of earlier\nconfig/rc/ini files.  --no-load-opts is handled early, out of order.\n",
                    "flag": "-r",
                    "long": "--no-load-opts"
                },
                {
                    "name": "-v --version",
                    "content": "Output version of program and exit.  The default mode is `v', a simple  version.   The\n`c'  mode  will  print copyright information and `n' will print the full copyright no‐\ntice.\n",
                    "flag": "-v",
                    "long": "--version"
                }
            ]
        },
        "OPTION PRESETS": {
            "content": "Any option that is not marked as not presettable may be preset by loading values from config‐\nuration (\"RC\" or \".INI\") file(s).  The file \"$HOME/.sharrc\" will be used, if present.\n",
            "subsections": []
        },
        "STANDARDS": {
            "content": "This implementation is compliant with P1003.2b/D11.\n",
            "subsections": []
        },
        "FILES": {
            "content": "See OPTION PRESETS for configuration files.\n",
            "subsections": []
        },
        "EXIT STATUS": {
            "content": "One of the following exit values will be returned:\n\n0  (EXITSUCCESS)\nSuccessful program execution.\n\n1  (EXITFAILURE)\nThe operation failed or the command syntax was not valid.\n\n66  (EXNOINPUT)\nA specified configuration file could not be loaded.\n\n70  (EXSOFTWARE)\nlibopts   had   an   internal   operational  error.   Please  report  it  to  autogen-\nusers@lists.sourceforge.net.  Thank you.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "uudecode(1), uuencode(5)\n",
            "subsections": []
        },
        "HISTORY": {
            "content": "The uuencode command first appeared in BSD 4.0.\n",
            "subsections": []
        },
        "AUTHORS": {
            "content": "Free Software Foundation, Inc.\n",
            "subsections": []
        },
        "COPYRIGHT": {
            "content": "Copyright (C) 1994-2015 Free Software Foundation, Inc. all rights reserved.  This program  is\nreleased under the terms of the GNU General Public License, version 3 or later.\n",
            "subsections": []
        },
        "BUGS": {
            "content": "Please  put sharutils in the subject line for emailed bug reports.  It helps to spot the mes‐\nsage.\n\nPlease send bug reports to: bug-gnu-utils@gnu.org\n",
            "subsections": []
        },
        "NOTES": {
            "content": "This manual page was AutoGen-erated from the uuencode option definitions.\n\n\n\nGNU sharutils (4.15.2)                       30 May 2015                                 uuencode(1)",
            "subsections": []
        }
    },
    "summary": "uuencode - encode a file into email friendly text",
    "flags": [
        {
            "flag": "-m",
            "long": "--base64",
            "arg": null,
            "description": "convert using base64. By default, uuencode will encode using the traditional conversion. It is slower and less compact than base64. The encoded form of the file is expanded by 37% for UU en‐ coding and by 35% for base64 encoding (3 bytes become 4 plus control information)."
        },
        {
            "flag": "-e",
            "long": "--encode-file-name",
            "arg": null,
            "description": "encode the output file name. Since output file names may contain characters that are not handled well by various transmission modes, you may specify that the output-name be base64 encoded as well. (Traditional uuencoding of the file name is not supported.)"
        },
        {
            "flag": "-h",
            "long": "--help",
            "arg": null,
            "description": "Display usage information and exit. -!, --more-help Pass the extended usage information through a pager."
        },
        {
            "flag": "-R",
            "long": "--save-opts",
            "arg": null,
            "description": "Save the option state to cfgfile. The default is the last configuration file listed in the OPTION PRESETS section, below. The command will exit after updating the config file."
        },
        {
            "flag": "-r",
            "long": "--no-load-opts",
            "arg": null,
            "description": "Load options from cfgfile. The no-load-opts form will disable the loading of earlier config/rc/ini files. --no-load-opts is handled early, out of order."
        },
        {
            "flag": "-v",
            "long": "--version",
            "arg": null,
            "description": "Output version of program and exit. The default mode is `v', a simple version. The `c' mode will print copyright information and `n' will print the full copyright no‐ tice."
        }
    ],
    "examples": [],
    "see_also": [
        {
            "name": "uudecode",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/uudecode/1/json"
        }
    ],
    "tldr": {
        "source": "official",
        "description": "Encode binary files into ASCII for transport via mediums that only support simple ASCII encoding.",
        "examples": [
            {
                "description": "Encode a file and print the result to `stdout`",
                "command": "uuencode {{path/to/input_file}} {{output_file_name_after_decoding}}"
            },
            {
                "description": "Encode a file and write the result to a file",
                "command": "uuencode -o {{path/to/output_file}} {{path/to/input_file}} {{output_file_name_after_decoding}}"
            },
            {
                "description": "Encode a file using Base64 instead of the default uuencode encoding and write the result to a file",
                "command": "uuencode {{-m|--base64}} -o {{path/to/output_file}} {{path/to/input_file}} {{output_file_name_after_decoding}}"
            }
        ]
    }
}