m4/lls/include/user.m4

   1 [option user]
   2         short_opt = u
   3         summary = run as the given user
   4         arg_info = required_arg
   5         arg_type = string
   6         typestr = username
   7         [help]
   8                 PROGRAM() does not need any special privileges.
   9
  10                 If started as root (EUID == 0) this option must be given at the
  11                 command line (not in the configuration file) so that PROGRAM()
  12                 can drop the root privileges right after parsing the command line
  13                 options, but before parsing the configuration file. In this case,
  14                 real/effective/saved UID are all set to the UID of <username>. As
  15                 the configuration file is read afterwards, those options that have
  16                 a default value depending on the UID (e.g. the directory for the
  17                 configuration file) are computed by using the uid of <username>. This
  18                 option has no effect if PROGRAM() is started as a non-root user (i.e.
  19                 EUID != 0).
  20         [/help]
  21