File: PORTING

package info (click to toggle)
sudo 1.5.6p2-2
  • links: PTS
  • area: main
  • in suites: slink
  • size: 972 kB
  • ctags: 874
  • sloc: ansic: 6,036; sh: 1,608; makefile: 209; perl: 47
file content (51 lines) | stat: -rw-r--r-- 2,658 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
sudo porting hints:

Before trying to port sudo to a new architecture, please join the
sudo-workers mailing list (see the README) and ask if anyone has
a port working or in-progress.

Sudo should be fairly easy to port.  In fact, now that it uses a configure
script, most of the work should be done for you.

If your OS is an SVR4 derivative (or some approximation thereof), it may
be sufficient to tell configure you are runnng SVR4, something like:
    configure foo-bar-sysv4
where foo is the hardware architecture and bar is the vendor.

A possible pitfall is getdtablesize(2) which is used to get the maximum
number of open files the process can have.  If an OS has the POSIX sysconf(2)
it will be used instead of getdtablesize(2).  ulimit(2) or getrlimit(2) can
also be used on some OS's.  If all else fails you can use the value of
NOFILE in <sys/param.h>.

Sudo tries to clear the environment of dangerous envariables like LD_*
to prevent shared library spoofing.  If you are porting sudo to a new
OS that has shared libraries you'll want to mask out the variables that
allow one to change the shared library path.  See badenv_table() in
sudo.c to see how this is done for various OS's.

It is possible that on a really weird system, tgetpass() may not compile.
(The most common cause for this is that the "fd_set" type is not
defined in a place that sudo expects it to be.  If you can fine the
header file where "fd_set" is typedef'd, have tgetpass.c include
it and send in a bug report.)
Alternately, it may compile but not work (nothing happens at Password: prompt).
It is possible that your C library contains a broken or unusable crypt()
function--try linking with -lcrypt if that exists.  Another possibility
is that select() is not fully functional; setting PASSWORD_TIMEOUT to
0 in options.h will disable the use of select().  If all else fails
you can run configure with the --with-getpass flag to use the system getpass().
You'll lose the timeout feature but gain a working sudo.
NOTE: S/Key and OPIE support will not work with most OS's getpass(3) routine.

If you are trying to port to a system without standard Berkeley
networking you may find that interfaces.c will not compile.  This
is most likely on OS's with STREAMS-based networking.  It should be
possible to make it work by modifying the ISC streams support
(see the _ISC #ifdef's).  However, if you don't care about ip address
and network address support, you can just define STUB_LOAD_INTERFACES
to get a do-nothing load_interfaces() stub function.

If you port sudo to a new architecture, please send the output of
"configure" and your changes to:
    sudo-bugs@courtesan.com