Return to PORTING CVS log

Up to [local] / src / usr.bin / sudo

Annotation of src/usr.bin/sudo/PORTING, Revision 1.1

1.1     ! millert     1: Sudo porting hints
        !             2: ==================
        !             3:
        !             4: Before trying to port sudo to a new architecture, please join the
        !             5: sudo-workers mailing list (see the README file) and ask if anyone
        !             6: has a port working or in-progress.  Sudo should be fairly easy to
        !             7: port.  Since it uses a configure script, most of the work should
        !             8: be done for you.
        !             9:
        !            10: If your OS is an SVR4 derivative (or some approximation thereof), it may
        !            11: be sufficient to tell configure you are runnng SVR4, something like:
        !            12:     configure foo-bar-sysv4
        !            13: where foo is the hardware architecture and bar is the vendor.
        !            14:
        !            15: A possible pitfall is getdtablesize(2) which is used to get the
        !            16: maximum number of open files the process can have.  If an OS has
        !            17: the POSIX sysconf(2) it will be used instead of getdtablesize(2).
        !            18: ulimit(2) or getrlimit(2) can also be used on some OS's.  If all
        !            19: else fails you can use the value of NOFILE in <sys/param.h>.
        !            20:
        !            21: Sudo tries to clear the environment of dangerous envariables like
        !            22: LD_* to prevent shared library spoofing.  If you are porting sudo
        !            23: to a new OS that has shared libraries you'll want to mask out the
        !            24: variables that allow one to change the shared library path.  See
        !            25: badenv_table() in sudo.c to see how this is done for various OS's.
        !            26:
        !            27: It is possible that on a really weird system, tgetpass() may not
        !            28: compile.  (The most common cause for this is that the "fd_set" type
        !            29: is not defined in a place that sudo expects it to be.  If you can
        !            30: find the header file where "fd_set" is typedef'd, have tgetpass.c
        !            31: include it and send in a bug report.)
        !            32: Alternately, tgetpass.c may compile but not work (nothing happens
        !            33: at the Password: prompt).  It is possible that your C library
        !            34: contains a broken or unusable crypt() function--try linking with
        !            35: -lcrypt if that exists.  Another possibility is that select() is
        !            36: not fully functional; running configure with --with-password-timeout=0
        !            37: will disable the use of select().
        !            38:
        !            39: If you are trying to port to a system without standard Berkeley
        !            40: networking you may find that interfaces.c will not compile.  This
        !            41: is most likely on OS's with STREAMS-based networking.  It should be
        !            42: possible to make it work by modifying the ISC streams support
        !            43: (see the _ISC #ifdef's).  However, if you don't care about ip address
        !            44: and network address support, you can just run configure with the
        !            45: --without-interfaces flag to get a do-nothing load_interfaces() stub function.
        !            46:
        !            47: If you port sudo to a new architecture, please send the output of
        !            48: "configure", the config.log file and your changes to:
        !            49:     sudo@courtesan.com
        !            50:
        !            51: If you are unable to get sudo working, and you are willing to
        !            52: give me an account on a machine, send mail to sudo@courtesan.com.
        !            53: Note, however, that I can't make any promises.