Control.Shell.Posix

Working with daemons, users, groups, file permissions and file ownerships. Not present on Windows unless shellmate is installed with the with-posix flag.

Users and groups

type User = String

type Group = String

getCurrentUser :: Shell String

Get the currently effective user name.

getCurrentGroups :: Shell [String]

Get the list of groups associated with the current process.

getOwner :: FilePath -> Shell User

Get the owner of the given file.

getGroup :: FilePath -> Shell Group

Get the group of the given file.

getOwnership :: FilePath -> Shell (User, Group)

Get the owner and group of the given file.

setOwner :: User -> FilePath -> Shell ()

Set the owner of the given file.

setGroup :: Group -> FilePath -> Shell ()

Set the group of the given file.

setOwnership :: User -> Group -> FilePath -> Shell ()

Set the owner and group of the given file.

File permissions

data CMode

Instances

Bounded CMode

Defined in System.Posix.Types

Methods

minBound :: CMode

maxBound :: CMode

Enum CMode

Defined in System.Posix.Types

Methods

succ :: CMode -> CMode

pred :: CMode -> CMode

toEnum :: Int -> CMode

fromEnum :: CMode -> Int

enumFrom :: CMode -> [CMode]

enumFromThen :: CMode -> CMode -> [CMode]

enumFromTo :: CMode -> CMode -> [CMode]

enumFromThenTo :: CMode -> CMode -> CMode -> [CMode]

Eq CMode

Defined in System.Posix.Types

Methods

(==) :: CMode -> CMode -> Bool

(/=) :: CMode -> CMode -> Bool

Integral CMode

Defined in System.Posix.Types

Methods

quot :: CMode -> CMode -> CMode

rem :: CMode -> CMode -> CMode

div :: CMode -> CMode -> CMode

mod :: CMode -> CMode -> CMode

quotRem :: CMode -> CMode -> (CMode, CMode)

divMod :: CMode -> CMode -> (CMode, CMode)

toInteger :: CMode -> Integer

Num CMode

Defined in System.Posix.Types

Methods

(+) :: CMode -> CMode -> CMode

(-) :: CMode -> CMode -> CMode

(*) :: CMode -> CMode -> CMode

negate :: CMode -> CMode

abs :: CMode -> CMode

signum :: CMode -> CMode

fromInteger :: Integer -> CMode

Ord CMode

Defined in System.Posix.Types

Methods

compare :: CMode -> CMode -> Ordering

(<) :: CMode -> CMode -> Bool

(<=) :: CMode -> CMode -> Bool

(>) :: CMode -> CMode -> Bool

(>=) :: CMode -> CMode -> Bool

max :: CMode -> CMode -> CMode

min :: CMode -> CMode -> CMode

Read CMode

Defined in System.Posix.Types

Methods

readsPrec :: Int -> ReadS CMode

readList :: ReadS [CMode]

readPrec :: ReadPrec CMode

readListPrec :: ReadPrec [CMode]

Real CMode

Defined in System.Posix.Types

Methods

toRational :: CMode -> Rational

Show CMode

Defined in System.Posix.Types

Methods

showsPrec :: Int -> CMode -> ShowS

show :: CMode -> String

showList :: [CMode] -> ShowS

Storable CMode

Defined in System.Posix.Types

Methods

sizeOf :: CMode -> Int

alignment :: CMode -> Int

peekElemOff :: Ptr CMode -> Int -> IO CMode

pokeElemOff :: Ptr CMode -> Int -> CMode -> IO ()

peekByteOff :: Ptr b -> Int -> IO CMode

pokeByteOff :: Ptr b -> Int -> CMode -> IO ()

peek :: Ptr CMode -> IO CMode

poke :: Ptr CMode -> CMode -> IO ()

Bits CMode

Defined in System.Posix.Types

Methods

(.&.) :: CMode -> CMode -> CMode

(.|.) :: CMode -> CMode -> CMode

xor :: CMode -> CMode -> CMode

complement :: CMode -> CMode

shift :: CMode -> Int -> CMode

rotate :: CMode -> Int -> CMode

zeroBits :: CMode

bit :: Int -> CMode

setBit :: CMode -> Int -> CMode

clearBit :: CMode -> Int -> CMode

complementBit :: CMode -> Int -> CMode

testBit :: CMode -> Int -> Bool

bitSizeMaybe :: CMode -> Maybe Int

bitSize :: CMode -> Int

isSigned :: CMode -> Bool

shiftL :: CMode -> Int -> CMode

unsafeShiftL :: CMode -> Int -> CMode

shiftR :: CMode -> Int -> CMode

unsafeShiftR :: CMode -> Int -> CMode

rotateL :: CMode -> Int -> CMode

rotateR :: CMode -> Int -> CMode

popCount :: CMode -> Int

FiniteBits CMode

Defined in System.Posix.Types

Methods

finiteBitSize :: CMode -> Int

countLeadingZeros :: CMode -> Int

countTrailingZeros :: CMode -> Int

unionFileModes :: FileMode -> FileMode -> FileMode

Combines the two file modes into one that contains modes that appear in either.

intersectFileModes :: FileMode -> FileMode -> FileMode

Combines two file modes into one that only contains modes that appear in both.

nullFileMode :: FileMode

No permissions.

ownerReadMode :: FileMode

Owner has read permission.

ownerWriteMode :: FileMode

Owner has write permission.

ownerExecuteMode :: FileMode

Owner has execute permission.

ownerModes :: FileMode

Owner has read, write and execute permission.

groupReadMode :: FileMode

Group has read permission.

groupWriteMode :: FileMode

Group has write permission.

groupExecuteMode :: FileMode

Group has execute permission.

groupModes :: FileMode

Group has read, write and execute permission.

otherReadMode :: FileMode

Others have read permission.

otherWriteMode :: FileMode

Others have write permission.

otherExecuteMode :: FileMode

Others have execute permission.

otherModes :: FileMode

Others have read, write and execute permission.

stdFileMode :: FileMode

Owner, group and others have read and write permission.

accessModes :: FileMode

Owner, group and others have read, write and execute permission.

setFileMode :: FilePath -> CMode -> Shell ()

Set the mode (permissions, etc.) of the given file.

getFileMode :: FilePath -> Shell CMode

Get the mode of the given file.

setFileCreationMask :: CMode -> Shell CMode

Set the file creation mask of this process.

Daemonizing shell computations

daemonize :: Shell () -> Shell ()

Daemonize a shellmate computation. This should be the last thing a computation does, as this function will terminate the parent computation. In short, daemonizing a computation involves setting the file creation mask to 0, closing standard input, output and error file descriptors, blocking sighup and changing the working directory to /.

On Windows without Cygwin, daemonize is a no-op. Consider running any program intended to be deamonized using START /B your_app, or better yet, rewriting it as a Windows service.