Differential D17547 Diff 49635 head/lib/libc/sys/chmod.2

Changeset View

Standalone View

head/lib/libc/sys/chmod.2

	Show All 22 Lines
	.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT			.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY			.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF			.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	.\" SUCH DAMAGE.			.\" SUCH DAMAGE.
	.\"			.\"
	.\" @(#)chmod.2 8.1 (Berkeley) 6/4/93			.\" @(#)chmod.2 8.1 (Berkeley) 6/4/93
	.\" $FreeBSD$			.\" $FreeBSD$
	.\"			.\"
	.Dd December 1, 2017			.Dd October 20, 2018
	.Dt CHMOD 2			.Dt CHMOD 2
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm chmod ,			.Nm chmod ,
	.Nm fchmod ,			.Nm fchmod ,
	.Nm lchmod ,			.Nm lchmod ,
	.Nm fchmodat			.Nm fchmodat
	.Nd change mode of file			.Nd change mode of file
	▲ Show 20 Lines • Show All 56 Lines • ▼ Show 20 Lines
	are constructed by a bitwise-inclusive OR of flags from the following list, defined			are constructed by a bitwise-inclusive OR of flags from the following list, defined
	in			in
	.In fcntl.h :			.In fcntl.h :
	.Bl -tag -width indent			.Bl -tag -width indent
	.It Dv AT_SYMLINK_NOFOLLOW			.It Dv AT_SYMLINK_NOFOLLOW
	If			If
	.Fa path			.Fa path
	names a symbolic link, then the mode of the symbolic link is changed.			names a symbolic link, then the mode of the symbolic link is changed.
				.It Dv AT_BENEATH
				Only allow to change permissions of a file which is beneath of
				the starting directory.
	.El			.El
	.Pp			.Pp
	If			If
	.Fn fchmodat			.Fn fchmodat
	is passed the special value			is passed the special value
	.Dv AT_FDCWD			.Dv AT_FDCWD
	in the			in the
	.Fa fd			.Fa fd
	▲ Show 20 Lines • Show All 168 Lines • ▼ Show 20 Lines
	.It Bq Er ENOTDIR			.It Bq Er ENOTDIR
	The			The
	.Fa path			.Fa path
	argument is not an absolute path and			argument is not an absolute path and
	.Fa fd			.Fa fd
	is neither			is neither
	.Dv AT_FDCWD			.Dv AT_FDCWD
	nor a file descriptor associated with a directory.			nor a file descriptor associated with a directory.
				.It Bq Er ENOTCAPABLE
				The
				.Dv AT_BENEATH
				flag was specified but
				.Fa path
				is not strictly relative to the starting directory.
				For example,
				.Fa path
				is absolute or includes a ".." component that escapes the starting directory.
	.El			.El
	.Sh SEE ALSO			.Sh SEE ALSO
	.Xr chmod 1 ,			.Xr chmod 1 ,
	.Xr chflags 2 ,			.Xr chflags 2 ,
	.Xr chown 2 ,			.Xr chown 2 ,
	.Xr open 2 ,			.Xr open 2 ,
	.Xr stat 2 ,			.Xr stat 2 ,
	.Xr sticky 7			.Xr sticky 7
	Show All 32 Lines