Annotation of researchv10dc/man/adm/man2/deprecated.2, revision 1.1.1.1

1.1       root        1: .TH DEPRECATED 2
                      2: .CT 2 misc
                      3: .SH NAME
                      4: reboot, vadvise, vlimit, vswapon, getgroups,
                      5: setgroups \(mi system calls to be avoided
                      6: .SH SYNOPSIS
                      7: .nf
                      8: .B int reboot(how)
                      9: .PP
                     10: .B int vadvise(how)
                     11: .PP
                     12: .B int vlimit(what, limit)
                     13: .PP
                     14: .B int vswapon(special)
                     15: .B char *special;
                     16: .PP
                     17: .B #include <sys/param.h>
                     18: .PP
                     19: .B int getgroups(ngroups, gidset)
                     20: .B short *gidset;
                     21: .PP
                     22: .B setgroups(ngroups, gidset)
                     23: .B short *gidset;
                     24: .fi
                     25: .SH DESCRIPTION
                     26: These calls are hangovers from prior versions of the system.
                     27: Some exist only for system maintenance purposes;
                     28: some depend on the virtual memory implementation.
                     29: None should be used except as a last resort.
                     30: Most are not included in
                     31: .BR /lib/libc.a .
                     32: .PP
                     33: .I Reboot
                     34: finishes any pending I/O
                     35: and reboots the system
                     36: (if
                     37: .I how
                     38: is 0)
                     39: or puts the system into a tight loop with interrupts disabled
                     40: (if
                     41: .I how
                     42: is 8).
                     43: It is restricted to the super-user.
                     44: .PP
                     45: .I Vadvise
                     46: gives the virtual memory system
                     47: hints about the paging behavior
                     48: of the current process.
                     49: .PP
                     50: .I Vlimit
                     51: sets various resource limits,
                     52: such as the amount of memory allowed for text and data,
                     53: and the maximum size of core images.
                     54: .PP
                     55: .I Vswapon
                     56: adds
                     57: the block device
                     58: .I special
                     59: to the pool of swap space.
                     60: The device must be listed in a table
                     61: compiled into the operating system;
                     62: .I vswapon
                     63: merely enables it.
                     64: .PP
                     65: .I Getgroups
                     66: stores at most
                     67: .I ngroups
                     68: elements of the group access list of the current process
                     69: in the array 
                     70: .IR gidset .
                     71: .PP
                     72: .I Setgroups
                     73: sets the group access list of the current user process from
                     74: .IR gidset .
                     75: .I Ngroups
                     76: gives the number of entries; it must not exceed
                     77: .BR NGROUPS ,
                     78: defined in
                     79: .BR <param.h> .
                     80: Only the super-user may add groups to the list.
                     81: .SH SEE ALSO
                     82: .I
                     83: Unix Programmer's Manual, Seventh Edition, Virtual VAX-11 Version,
                     84: Volume 1, 1980 (Berkeley)

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.