From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id 9BE941392EF for ; Sun, 13 Jul 2014 16:25:25 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 8DAB1E07A5; Sun, 13 Jul 2014 16:25:23 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 1BF6CE07A5 for ; Sun, 13 Jul 2014 16:25:23 +0000 (UTC) Received: from spoonbill.gentoo.org (spoonbill.gentoo.org [81.93.255.5]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 4D9AE33FB78 for ; Sun, 13 Jul 2014 16:25:22 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by spoonbill.gentoo.org (Postfix) with ESMTP id 18FB3193E5 for ; Sun, 13 Jul 2014 16:25:21 +0000 (UTC) From: "William Hubbs" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "William Hubbs" Message-ID: <1405268623.40141244e349e6e1d2dfb9ebfbcbf62f68d33a9d.williamh@OpenRC> Subject: [gentoo-commits] proj/openrc:master commit in: man/ X-VCS-Repository: proj/openrc X-VCS-Files: man/openrc-run.8 X-VCS-Directories: man/ X-VCS-Committer: williamh X-VCS-Committer-Name: William Hubbs X-VCS-Revision: 40141244e349e6e1d2dfb9ebfbcbf62f68d33a9d X-VCS-Branch: master Date: Sun, 13 Jul 2014 16:25:21 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Archives-Salt: 0cc71ea4-c9cd-4f5c-94c7-266e31b1bcc9 X-Archives-Hash: 39160e6d46ea1344f47b761ad8400ea2 commit: 40141244e349e6e1d2dfb9ebfbcbf62f68d33a9d Author: William Hubbs gmail com> AuthorDate: Sun Jul 13 16:15:26 2014 +0000 Commit: William Hubbs gentoo org> CommitDate: Sun Jul 13 16:23:43 2014 +0000 URL: http://git.overlays.gentoo.org/gitweb/?p=proj/openrc.git;a=commit;h=40141244 man/openrc-run.8: more updates and clarifications for checkpath X-Gentoo-Bug: 500606 X-Gentoo-Bug-URL: https://bugs.gentoo.org/show_bug.cgi?id=500606 --- man/openrc-run.8 | 39 ++++++++++++++++++++++----------------- 1 file changed, 22 insertions(+), 17 deletions(-) diff --git a/man/openrc-run.8 b/man/openrc-run.8 index 07f3527..3890f76 100644 --- a/man/openrc-run.8 +++ b/man/openrc-run.8 @@ -322,30 +322,35 @@ Mark the service as inactive. .Op Fl p , -pipe .Op Fl m , -mode Ar mode .Op Fl o , -owner Ar owner +.Op Fl W , -writable .Op Fl q , -quiet .Ar path ... .Xc -Checks to see if the path exists, is of the right type, owned by the right -people and has the correct access modes. If not, then it corrects the path. +If -d, -f or -p is specified, checkpath checks to see if the path +exists, is the right type and has the correct owner and access modes. If +any of these tests fail, the path is created and set up as specified. If +more than one of -d, -f or -p are specified, the last one will be used. -Type. -File, directory and pipe types are supported, if type is not provided then -directory is used +The argument to -m is a three or four digit octal number. If this option +is not provided, the value defaults to 0644 for files and 0775 for +directories. -Mode. -Mode should be provided as a three (644) or four digit string (0644). If mode -is argument is not provided then default value is used: 0644 - for files, and -0775 for directories. +The argument to -o is a representation of the user and/or group which +should own the path. The user and group can be represented numerically +or with names, and are separated by a colon. -Truncate variant of options create empty directory or file, or clears contents -if it exists. +The truncate options (-D and -F) cause the directory or file to be +cleared of all contents. -Quiet argument suppress normal output, repeat quiet argument to suppress errors. -.It Ic checkpath -.Op Fl W , -writable -.Ar path -.Xc -checks to see if the path is writable. +If -W is specified, checkpath checks to see if the first path given on +the command line is writable. This is different from how the test +command in the shell works, because it also checks to make sure the file +system is not read only. + +Also, the -d, -f or -p options should not be specified along with this option. + +The -q option suppresses all informational output. If it is specified +twice, all error messages are suppressed as well. .It Ic yesno Ar value If .Ar value