|
|
1.1 ! root 1: .\" Copyright (c) 1989 The Regents of the University of California. ! 2: .\" All rights reserved. ! 3: .\" ! 4: .\" Redistribution and use in source and binary forms are permitted provided ! 5: .\" that: (1) source distributions retain this entire copyright notice and ! 6: .\" comment, and (2) distributions including binaries display the following ! 7: .\" acknowledgement: ``This product includes software developed by the ! 8: .\" University of California, Berkeley and its contributors'' in the ! 9: .\" documentation or other materials provided with the distribution and in ! 10: .\" all advertising materials mentioning features or use of this software. ! 11: .\" Neither the name of the University nor the names of its contributors may ! 12: .\" be used to endorse or promote products derived from this software without ! 13: .\" specific prior written permission. ! 14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED ! 15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF ! 16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. ! 17: .\" ! 18: .\" @(#)setmode.3 5.3 (Berkeley) 6/23/90 ! 19: .\" ! 20: .TH SETMODE 3 "June 23, 1990" ! 21: .UC 7 ! 22: .SH NAME ! 23: getmode, setmode \- modify mode bits ! 24: .SH SYNOPSIS ! 25: .nf ! 26: .ft B ! 27: getmode(set, mode) ! 28: mode_t *set, mode; ! 29: ! 30: set = setmode(mode_str) ! 31: mode_t *set; ! 32: char *mode_str; ! 33: .ft R ! 34: .fi ! 35: .SH DESCRIPTION ! 36: .I Getmode ! 37: returns a copy of the file permission bits ! 38: .I mode ! 39: as altered by the values pointed to by ! 40: .IR set . ! 41: While only the mode bits are altered, other parts of the file mode ! 42: may be examined. ! 43: .PP ! 44: .I Setmode ! 45: takes an absolute (octal) or symbolic value, as described in ! 46: .IR chmod (1), ! 47: as an argument ! 48: and returns a pointer to mode values to be supplied to ! 49: .IR getmode . ! 50: Because some of the symbolic values are relative to the file ! 51: creation mask, ! 52: .I setmode ! 53: may call ! 54: .IR umask (2). ! 55: If this occurs, the file creation mask will be restored before ! 56: .I setmode ! 57: returns. ! 58: If the calling program changes the value of its file creation mask ! 59: after calling ! 60: .IR setmode , ! 61: .I setmode ! 62: must be called again if ! 63: .I getmode ! 64: is to modify future file modes correctly. ! 65: .PP ! 66: If the mode passed to ! 67: .I setmode ! 68: is invalid, ! 69: .I setmode ! 70: returns NULL. ! 71: .SH ERRORS ! 72: .I Setmode ! 73: may fail and set errno for any of the errors specified for the library ! 74: routine ! 75: .IR malloc (3). ! 76: .SH SEE ALSO ! 77: chmod(1), stat(2), umask(2), malloc(3)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.