getmode man page on NetBSD

Man page or keyword search:  
man Server   9087 pages
apropos Keyword Search (all sections)
Output format
NetBSD logo
[printable version]

SETMODE(3)		 BSD Library Functions Manual		    SETMODE(3)

NAME
     getmode, setmode — modify mode bits

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <unistd.h>

     void *
     setmode(const char *mode_str);

     mode_t
     getmode(const void *set, mode_t mode);

DESCRIPTION
     The setmode() function accepts a string representation of a file mode
     change, compiles it to binary form, and returns an abstract representa‐
     tion that may be passed to getmode().  The string may be an numeric
     (octal) or symbolic string of the form accepted by chmod(1), and may rep‐
     resent either an exact mode to set or a change to make to the existing
     mode.

     The getmode() function adjusts the file permission bits given by mode
     according to the compiled change representation set, and returns the
     adjusted mode.  While only the permission bits are altered, other parts
     of the file mode, particularly the type, may be examined.

     Because some of the possible symbolic values are defined relative to the
     file creation mask, setmode() may call umask(2), temporarily changing the
     mask.  If this occurs, the file creation mask will be restored before
     setmode() returns.	 If the calling program changes the value of its file
     creation mask after calling setmode(), setmode() must be called again to
     recompile the mode string if getmode() is to modify future file modes
     correctly.

     If the mode passed to setmode() is invalid, setmode() returns NULL.

EXAMPLES
     The effects of the shell command ‘chmod a+x myscript.sh’ can be dupli‐
     cated as follows:

	   const char *file = "myscript.sh";
	   struct stat st;
	   mode_t newmode;

	   stat(file, &st);
	   newmode = getmode(setmode("a+x"), st.st_mode);
	   chmod(file, newmode);

ERRORS
     The setmode() function may fail and set errno for any of the errors spec‐
     ified for the library routines malloc(3) or strtol(3).  In addition,
     setmode() will fail and set errno to:

     [EINVAL]		The mode argument does not represent a valid mode.

SEE ALSO
     chmod(1), stat(2), umask(2), malloc(3)

HISTORY
     The getmode() and setmode() functions first appeared in 4.4BSD.

BUGS
     Each call to setmode allocates a small amount of memory that there is no
     correct way to free.

     The type of set should really be some opaque struct type used only by
     these functions rather than void *.

BSD				January 4, 2009				   BSD
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server NetBSD

List of man pages available for NetBSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net