Safe Haskell	Safe
Language	Haskell2010

System.IO.Temp

Contents

Re-exports from System.IO
Auxiliary functions

Description

Functions to create temporary files and directories.

Most functions come in two flavours: those that create files/directories under the system standard temporary directory and those that use the user-supplied directory.

The functions that create files/directories under the system standard temporary directory will return canonical absolute paths (see getCanonicalTemporaryDirectory). The functions use the user-supplied directory do not canonicalize the returned path.

The action inside withTempFile or withTempDirectory is allowed to remove the temporary file/directory if it needs to.

Synopsis

Documentation

withSystemTempFile #

Arguments

:: (MonadIO m, MonadMask m)
=> String	File name template. See `openTempFile`.
-> (FilePath -> Handle -> m a)	Callback that can use the file
-> m a

Create and use a temporary file in the system standard temporary directory.

Behaves exactly the same as withTempFile, except that the parent temporary directory will be that returned by getCanonicalTemporaryDirectory.

withSystemTempDirectory #

Arguments

:: (MonadIO m, MonadMask m)
=> String	Directory name template. See `openTempFile`.
-> (FilePath -> m a)	Callback that can use the directory
-> m a

Create and use a temporary directory in the system standard temporary directory.

Behaves exactly the same as withTempDirectory, except that the parent temporary directory will be that returned by getCanonicalTemporaryDirectory.

withTempFile #

Arguments

:: (MonadIO m, MonadMask m)
=> FilePath	Temp dir to create the file in
-> String	File name template. See `openTempFile`.
-> (FilePath -> Handle -> m a)	Callback that can use the file
-> m a

Use a temporary filename that doesn't already exist.

Creates a new temporary file inside the given directory, making use of the template. The temp file is deleted after use. For example:

withTempFile "src" "sdist." $ \tmpFile hFile -> do ...

The tmpFile will be file in the given directory, e.g. src/sdist.342.

withTempDirectory #

Arguments

:: (MonadMask m, MonadIO m)
=> FilePath	Temp directory to create the directory in
-> String	Directory name template. See `openTempFile`.
-> (FilePath -> m a)	Callback that can use the directory
-> m a

Create and use a temporary directory.

Creates a new temporary directory inside the given directory, making use of the template. The temp directory is deleted after use. For example:

withTempDirectory "src" "sdist." $ \tmpDir -> do ...

The tmpDir will be a new subdirectory of the given directory, e.g. src/sdist.342.

openNewBinaryFile :: FilePath -> String -> IO (FilePath, Handle) #

Like openBinaryTempFile, but uses 666 rather than 600 for the permissions.

Equivalent to openBinaryTempFileWithDefaultPermissions.

createTempDirectory #

Arguments

:: FilePath	Temp directory to create the directory in
-> String	Directory name template
-> IO FilePath

Create a temporary directory. See withTempDirectory.

writeTempFile #

Arguments

:: FilePath	Directory in which to create the file
-> String	File name template.
-> String	Data to store in the file.
-> IO FilePath	Path to the (written and closed) file.

Create a unique new file, write (text mode) a given data string to it, and close the handle again. The file will not be deleted automatically, and only the current user will have permission to access the file (see openTempFile for details).

Since: 1.2.1

writeSystemTempFile #

Arguments

:: String	File name template.
-> String	Data to store in the file.
-> IO FilePath	Path to the (written and closed) file.

Like writeTempFile, but use the system directory for temporary files.

Since: 1.2.1

emptyTempFile #

Arguments

:: FilePath	Directory in which to create the file
-> String	File name template.
-> IO FilePath	Path to the (written and closed) file.

Create a unique new empty file. (Equivalent to writeTempFile with empty data string.) This is useful if the actual content is provided by an external process.

Since: 1.2.1

emptySystemTempFile #

Arguments

:: String	File name template.
-> IO FilePath	Path to the (written and closed) file.

Like emptyTempFile, but use the system directory for temporary files.

Since: 1.2.1

Re-exports from System.IO

openTempFile #

Arguments

:: FilePath	Directory in which to create the file
-> String	File name template. If the template is "foo.ext" then the created file will be "fooXXX.ext" where XXX is some random number.
-> IO (FilePath, Handle)

The function creates a temporary file in ReadWrite mode. The created file isn't deleted automatically, so you need to delete it manually.

The file is creates with permissions such that only the current user can read/write it.

With some exceptions (see below), the file will be created securely in the sense that an attacker should not be able to cause openTempFile to overwrite another file on the filesystem using your credentials, by putting symbolic links (on Unix) in the place where the temporary file is to be created. On Unix the O_CREAT and O_EXCL flags are used to prevent this attack, but note that O_EXCL is sometimes not supported on NFS filesystems, so if you rely on this behaviour it is best to use local filesystems only.

openBinaryTempFile :: FilePath -> String -> IO (FilePath, Handle) #

Like openTempFile, but opens the file in binary mode. See openBinaryFile for more comments.

Auxiliary functions

getCanonicalTemporaryDirectory :: IO FilePath #

Return the absolute and canonical path to the system temporary directory.

>>> setCurrentDirectory "/home/feuerbach/"
>>> setEnv "TMPDIR" "."
>>> getTemporaryDirectory
"."
>>> getCanonicalTemporaryDirectory
"/home/feuerbach"