.\"
.\" Copyright (c) Christos Zoulas 2003.
.\" All Rights Reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice immediately at the beginning of the file, without modification,
.\"    this list of conditions, and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR
.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" 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
.\" SUCH DAMAGE.
.\"
.\" Japanese Version Copyright (c) 2003-2004 Yuichi SATO
.\"         all rights reserved.
.\" Translated Tue Jun  3 03:07:43 JST 2003
.\"         by Yuichi SATO <ysato444@yahoo.co.jp>
.\" Updated & Modified Sat Jan 31 21:47:17 JST 2004 by Yuichi SATO
.\"
.\"WORD:        
.\"
.Dd March 22, 2003
.Dt MAGIC 3
.Os
.Sh ̾
.Nm magic_open ,
.Nm magic_close ,
.Nm magic_error ,
.Nm magic_file ,
.Nm magic_buffer ,
.Nm magic_setflags ,
.Nm magic_check ,
.Nm magic_compile ,
.Nm magic_load
.Nd ޥåʥС̥饤֥
.Sh 饤֥
.Lb libmagic
.Sh 
.In magic.h
.Ft magic_t
.Fn magic_open "int flags"
.Ft void
.Fn magic_close "magic_t cookie"
.Ft const char *
.Fn magic_error "magic_t cookie"
.Ft int
.Fn magic_errno "magic_t cookie"
.Ft const char *
.Fn magic_file "magic_t cookie, const char *filename"
.Ft const char *
.Fn magic_buffer "magic_t cookie, const void *buffer, size_t length"
.Ft int
.Fn magic_setflags "magic_t cookie, int flags"
.Ft int
.Fn magic_check "magic_t cookie, const char *filename"
.Ft int
.Fn magic_compile "magic_t cookie, const char *filename"
.Ft int
.Fn magic_load "magic_t cookie, const char *filename"
.Sh 
δؿ
.Xr magic 4
˵ҤƤ magic ǡ١ե롣
.Pp
ؿ
.Fn magic_open
ϥޥååݥ󥿤֤
ޥååγƤ˥顼ä硢
δؿ NULL ֤
.Ar flags
ϡ¾Υޥåؿεưꤹ롣
.Bl -tag -width MAGIC_COMPRESS
.It Dv MAGIC_NONE
̤ʽԤʤ
.It Dv MAGIC_DEBUG
ɸ२顼Ϥ˥ǥХååɽ롣
.It Dv MAGIC_SYMLINK
ꤷե뤬ܥå󥯤Ǥäϡé롣
.It Dv MAGIC_COMPRESS
ե뤬̤ƤϡŸƤɤ߹ࡣ
.It Dv MAGIC_DEVICES
ե뤬֥åڥǥХޤ
饯ڥǥХǤä硢
ǥХ򥪡ץ󤷤Ƥɤ߹⤦Ȥ롣
.It Dv MAGIC_MIME
ʸǤϤʤ mime ʸ֤
.It Dv MAGIC_CONTINUE
ǽ˥ޥåΤǤϤʤޥåƤ֤
.It Dv MAGIC_CHECK
magic ǡ١å
ɸ२顼Ϥ˷ٹɽ롣
.It Dv MAGIC_PRESERVE_ATIME
.Xr utime 2
ޤ
.Xr utimes 2
򥵥ݡȤ륷ƥǤϡ
Ϥ줿եΥ¸褦Ȥ롣
.It Dv MAGIC_RAW
ǽʸ \eooo Τ褦 8 ʿɽѴʤ
.It Dv MAGIC_ERROR
ե䥷ܥå󥯤򥪡ץ󤷤褦ȤƤ֤
OS Υ顼ä硢
ޥåХåե˥顼ɽºݤΥ顼Ȥư
.El
.Pp
.Fn magic_close
ؿ
.Xr magic 4
ǡ١򥯥ơѤƤƤΥ꥽롣
.Pp
.Fn magic_error
ؿϺǸȯ顼ʸ֤
顼ʤ NULL ֤
.Pp
.Fn magic_errno
ؿϥƥॳˤäƺǸȯ OS 顼ֹ
.Xr ( errno 3 )
֤
.Pp
.Fn magic_file
ؿ
.Ar filename
ǻꤵ줿եƤˤĤƤʸ֤
顼ä NULL ֤
.Ar filename
 NULL ξɸϤȤ
.Pp
.Fn magic_buffer
ؿϥХȥ
.Ar length
ΰ
.Ar buffer
ƤˤĤơʸ֤
.Pp
.Fn magic_setflags
ؿϾ嵭
.Ar flags
ꤹ롣
.Pp
.Fn magic_check
ؿȤäơǡ١եΥȥ꤬ͭǤ뤫򸡾ڤǤ롣
ڤǡ١ϡڤΥեꥹȤηǡ
.Ar filename
ǻꤵ롣
.Ar filename
 NULL ξϥǥեȤΥǡ١򸡾ڤ롣
ڤ 0 ֤
Ԥ -1 ֤
.Pp
.Fn magic_compile
ؿȤäơǡ١򥳥ѥǤ롣
ѥ뤵ǡ١ϡڤΥեꥹȤηǡ
.Ar filename
ǻꤵ롣
.Ar filename
 NULL ξϡǥեȤΥǡ١ѥ뤵롣
ѥ뤬 0 ֤
Ԥ -1 ֤
ѥ뤷줿ե̾ϡ
ƥե
.Xr basename 1
ŬѤ ".mgc" ɲäΤˤʤ롣
.Pp
ޥå¹Ԥˤϡ
.Fn magic_load
ؿȤäƥǡ١եɤʤФʤʤ
ɤǡ١ϡڤΥեꥹȤηǡ
.Ar filename
ǻꤵ롣
.Ar filename
 NULL ξϡǥեȤΥǡ١ɤ롣
.Pp
ǥեȤΥǡ١եϡ
Ķѿ MAGIC ˤä̾ꤵ롣
δĶѿꤵʤ硢
ǥեȤΥǡ١ե̾ /usr/share/file/magic Ǥ롣
.Pp
.Fn magic_load
ǡ١ե̾ ".mime"  ".mgc" Ŭɲä
(ɤ餫ξ⤢)
.Sh ֤
ؿ
.Fn magic_open
ϥޥåå֤롣
Ԥ NULL ֤ơ
errno Ŭڤͤꤵ롣
ݡȤƤʤͤե饰˻ꤵ줿硢
errno  EINVAL ꤵ롣
.Fn magic_load ,
.Fn magic_compile ,
.Fn magic_check
ؿ 0 ֤졢Ԥ -1 ֤롣
.Fn magic_file ,
.Fn magic_buffer 
ؿʸ֤졢Ԥ NULL ֤롣
.Fn magic_error
ؿϾ嵭δؿΥ顼ʸ֤
顼ʤ NULL ֤
ơ
.Xr utime 2
ޤ
.Xr utimes 2
ݡȤƤʤƥ
.Dv MAGIC_PRESERVE_ATIME
ꤵȡ
.Fn magic_setflags
 -1 ֤
.Sh ե
.Bl -tag -width /usr/share/file/magic.mime.mgc -compact
.It Pa /usr/share/file/magic.mime
ѥ뤵ƤʤǥեȤ magic mime ǡ١
.It Pa /usr/share/file/magic.mime.mgc
ѥѤߤΥǥեȤ magic mime ǡ١
.It Pa /usr/share/file/magic
ѥ뤵ƤʤǥեȤ magic ǡ١
.It Pa /usr/share/file/magic.mgc
ѥѤߤΥǥեȤ magic ǡ١
.El
.Sh Ϣ
.Xr file 1 ,
.Xr magic 4 
.Sh 
Mans Rullgard ǽ libmagic μȹԤä
Christos Zoulas  API 
顼ɤ (ޥåå) Ƥ