{-# LINE 1 "src/Magic/Types.hsc" #-}
{-  -*- Mode: haskell; -*-
Haskell magic Interface
Copyright (C) 2005 John Goerzen <jgoerzen@complete.org>

This code is under a 3-clause BSD license; see COPYING for details.
-}

{-# LANGUAGE DeriveGeneric #-}

{- |
   Module     : Magic.Types
   Copyright  : Copyright (C) 2005 John Goerzen
   License    : BSD-3-Clause

   Maintainer : Philippe <philippedev101\@gmail.com>
   Stability  : provisional
   Portability: portable

The core types of the binding: the opaque t'Magic' handle, the t'MagicException'
error type (both defined in "Magic.Internal"), and the 'MagicParam' tunables.
The flag bit-mask lives in "Magic.Data".
-}

module Magic.Types(Magic,
                   MagicException(..),
                   MagicParam(..))
where
import Control.DeepSeq (NFData(rnf))
import GHC.Generics (Generic)
import Magic.Internal (Magic, MagicException(..))

{- | Tunable limits that bound how hard @libmagic@ works when examining data,
read and written with @magicGetParam@ and @magicSetParam@ (see
"Magic.Operations"). Lowering these (especially 'MagicParamBytesMax') is a way
to cap the effort spent on untrusted input. Defaults below are those documented
for @libmagic@ 5.45.

@since 1.1.2
-}
data MagicParam
    = -- | Maximum number of levels of recursion when following indirect magic. (Default: 15.)
      MagicParamIndirMax
    | -- | Maximum length of a name used by name\/use magic. (Default: 30.)
      MagicParamNameMax
    | -- | Maximum number of ELF program header sections processed. (Default: 128.)
      MagicParamElfPhnumMax
    | -- | Maximum number of ELF section header sections processed. (Default: 32768.)
      MagicParamElfShnumMax
    | -- | Maximum number of ELF notes processed. (Default: 256.)
      MagicParamElfNotesMax
    | -- | Maximum length of a regex search. (Default: 8192.)
      MagicParamRegexMax
    | -- | Maximum number of bytes read from a file before giving up. (Default: 1048576, i.e. 1 MiB.)
      MagicParamBytesMax
    | -- | Maximum number of bytes scanned when guessing a text encoding.
      MagicParamEncodingMax
    | -- | Maximum size of an ELF section processed.
      MagicParamElfShsizeMax
  deriving (Int -> MagicParam -> ShowS
[MagicParam] -> ShowS
MagicParam -> String
(Int -> MagicParam -> ShowS)
-> (MagicParam -> String)
-> ([MagicParam] -> ShowS)
-> Show MagicParam
forall a.
(Int -> a -> ShowS) -> (a -> String) -> ([a] -> ShowS) -> Show a
$cshowsPrec :: Int -> MagicParam -> ShowS
showsPrec :: Int -> MagicParam -> ShowS
$cshow :: MagicParam -> String
show :: MagicParam -> String
$cshowList :: [MagicParam] -> ShowS
showList :: [MagicParam] -> ShowS
Show, MagicParam -> MagicParam -> Bool
(MagicParam -> MagicParam -> Bool)
-> (MagicParam -> MagicParam -> Bool) -> Eq MagicParam
forall a. (a -> a -> Bool) -> (a -> a -> Bool) -> Eq a
$c== :: MagicParam -> MagicParam -> Bool
== :: MagicParam -> MagicParam -> Bool
$c/= :: MagicParam -> MagicParam -> Bool
/= :: MagicParam -> MagicParam -> Bool
Eq, Eq MagicParam
Eq MagicParam =>
(MagicParam -> MagicParam -> Ordering)
-> (MagicParam -> MagicParam -> Bool)
-> (MagicParam -> MagicParam -> Bool)
-> (MagicParam -> MagicParam -> Bool)
-> (MagicParam -> MagicParam -> Bool)
-> (MagicParam -> MagicParam -> MagicParam)
-> (MagicParam -> MagicParam -> MagicParam)
-> Ord MagicParam
MagicParam -> MagicParam -> Bool
MagicParam -> MagicParam -> Ordering
MagicParam -> MagicParam -> MagicParam
forall a.
Eq a =>
(a -> a -> Ordering)
-> (a -> a -> Bool)
-> (a -> a -> Bool)
-> (a -> a -> Bool)
-> (a -> a -> Bool)
-> (a -> a -> a)
-> (a -> a -> a)
-> Ord a
$ccompare :: MagicParam -> MagicParam -> Ordering
compare :: MagicParam -> MagicParam -> Ordering
$c< :: MagicParam -> MagicParam -> Bool
< :: MagicParam -> MagicParam -> Bool
$c<= :: MagicParam -> MagicParam -> Bool
<= :: MagicParam -> MagicParam -> Bool
$c> :: MagicParam -> MagicParam -> Bool
> :: MagicParam -> MagicParam -> Bool
$c>= :: MagicParam -> MagicParam -> Bool
>= :: MagicParam -> MagicParam -> Bool
$cmax :: MagicParam -> MagicParam -> MagicParam
max :: MagicParam -> MagicParam -> MagicParam
$cmin :: MagicParam -> MagicParam -> MagicParam
min :: MagicParam -> MagicParam -> MagicParam
Ord, Int -> MagicParam
MagicParam -> Int
MagicParam -> [MagicParam]
MagicParam -> MagicParam
MagicParam -> MagicParam -> [MagicParam]
MagicParam -> MagicParam -> MagicParam -> [MagicParam]
(MagicParam -> MagicParam)
-> (MagicParam -> MagicParam)
-> (Int -> MagicParam)
-> (MagicParam -> Int)
-> (MagicParam -> [MagicParam])
-> (MagicParam -> MagicParam -> [MagicParam])
-> (MagicParam -> MagicParam -> [MagicParam])
-> (MagicParam -> MagicParam -> MagicParam -> [MagicParam])
-> Enum MagicParam
forall a.
(a -> a)
-> (a -> a)
-> (Int -> a)
-> (a -> Int)
-> (a -> [a])
-> (a -> a -> [a])
-> (a -> a -> [a])
-> (a -> a -> a -> [a])
-> Enum a
$csucc :: MagicParam -> MagicParam
succ :: MagicParam -> MagicParam
$cpred :: MagicParam -> MagicParam
pred :: MagicParam -> MagicParam
$ctoEnum :: Int -> MagicParam
toEnum :: Int -> MagicParam
$cfromEnum :: MagicParam -> Int
fromEnum :: MagicParam -> Int
$cenumFrom :: MagicParam -> [MagicParam]
enumFrom :: MagicParam -> [MagicParam]
$cenumFromThen :: MagicParam -> MagicParam -> [MagicParam]
enumFromThen :: MagicParam -> MagicParam -> [MagicParam]
$cenumFromTo :: MagicParam -> MagicParam -> [MagicParam]
enumFromTo :: MagicParam -> MagicParam -> [MagicParam]
$cenumFromThenTo :: MagicParam -> MagicParam -> MagicParam -> [MagicParam]
enumFromThenTo :: MagicParam -> MagicParam -> MagicParam -> [MagicParam]
Enum, MagicParam
MagicParam -> MagicParam -> Bounded MagicParam
forall a. a -> a -> Bounded a
$cminBound :: MagicParam
minBound :: MagicParam
$cmaxBound :: MagicParam
maxBound :: MagicParam
Bounded, (forall x. MagicParam -> Rep MagicParam x)
-> (forall x. Rep MagicParam x -> MagicParam) -> Generic MagicParam
forall x. Rep MagicParam x -> MagicParam
forall x. MagicParam -> Rep MagicParam x
forall a.
(forall x. a -> Rep a x) -> (forall x. Rep a x -> a) -> Generic a
$cfrom :: forall x. MagicParam -> Rep MagicParam x
from :: forall x. MagicParam -> Rep MagicParam x
$cto :: forall x. Rep MagicParam x -> MagicParam
to :: forall x. Rep MagicParam x -> MagicParam
Generic)

instance NFData MagicParam where rnf :: MagicParam -> ()
rnf MagicParam
x = MagicParam
x MagicParam -> () -> ()
forall a b. a -> b -> b
`seq` ()