
/* Chrysalide - Outil d'analyse de fichiers binaires
 * mime-encoding.c - reconnaissance de l'encodage d'un contenu
 *
 * Copyright (C) 2023 Cyrille Bagard
 *
 *  This file is part of Chrysalide.
 *
 *  Chrysalide is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 3 of the License, or
 *  (at your option) any later version.
 *
 *  Chrysalide is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with Foobar.  If not, see <http://www.gnu.org/licenses/>.
 */


#include "mime-encoding.h"


#include "cookie.h"
#include "../../item-int.h"
#include "../../exprs/literal.h"



/* ---------------------- INTRODUCTION D'UNE NOUVELLE FONCTION ---------------------- */


/* Initialise la classe des reconnaissances de contenus. */
static void g_scan_mime_encoding_function_class_init(GScanMimeEncodingFunctionClass *);

/* Initialise une instance de reconnaissance de contenus. */
static void g_scan_mime_encoding_function_init(GScanMimeEncodingFunction *);

/* Supprime toutes les références externes. */
static void g_scan_mime_encoding_function_dispose(GScanMimeEncodingFunction *);

/* Procède à la libération totale de la mémoire. */
static void g_scan_mime_encoding_function_finalize(GScanMimeEncodingFunction *);



/* --------------------- IMPLEMENTATION DES FONCTIONS DE CLASSE --------------------- */


/* Indique le nom associé à une expression d'évaluation. */
static char *g_scan_mime_encoding_function_get_name(const GScanMimeEncodingFunction *);

/* Réduit une expression à une forme plus simple. */
static bool g_scan_mime_encoding_function_run_call(GScanMimeEncodingFunction *, GScanExpression **, size_t, GScanContext *, GScanScope *, GObject **);



/* ---------------------------------------------------------------------------------- */
/*                        INTRODUCTION D'UNE NOUVELLE FONCTION                        */
/* ---------------------------------------------------------------------------------- */


/* Indique le type défini pour une reconnaissance d'encodages de contenus. */
G_DEFINE_TYPE(GScanMimeEncodingFunction, g_scan_mime_encoding_function, G_TYPE_REGISTERED_ITEM);


/******************************************************************************
*                                                                             *
*  Paramètres  : klass = classe à initialiser.                                *
*                                                                             *
*  Description : Initialise la classe des reconnaissances de contenus.        *
*                                                                             *
*  Retour      : -                                                            *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

static void g_scan_mime_encoding_function_class_init(GScanMimeEncodingFunctionClass *klass)
{
    GObjectClass *object;                   /* Autre version de la classe  */
    GRegisteredItemClass *registered;       /* Version de classe parente   */

    object = G_OBJECT_CLASS(klass);

    object->dispose = (GObjectFinalizeFunc/* ! */)g_scan_mime_encoding_function_dispose;
    object->finalize = (GObjectFinalizeFunc)g_scan_mime_encoding_function_finalize;

    registered = G_REGISTERED_ITEM_CLASS(klass);

    registered->get_name = (get_registered_item_name_fc)g_scan_mime_encoding_function_get_name;
    registered->run_call = (run_registered_item_call_fc)g_scan_mime_encoding_function_run_call;

}


/******************************************************************************
*                                                                             *
*  Paramètres  : func = instance à initialiser.                               *
*                                                                             *
*  Description : Initialise une instance de reconnaissance de contenus.       *
*                                                                             *
*  Retour      : -                                                            *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

static void g_scan_mime_encoding_function_init(GScanMimeEncodingFunction *func)
{

}


/******************************************************************************
*                                                                             *
*  Paramètres  : func = instance d'objet GLib à traiter.                      *
*                                                                             *
*  Description : Supprime toutes les références externes.                     *
*                                                                             *
*  Retour      : -                                                            *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

static void g_scan_mime_encoding_function_dispose(GScanMimeEncodingFunction *func)
{
    G_OBJECT_CLASS(g_scan_mime_encoding_function_parent_class)->dispose(G_OBJECT(func));

}


/******************************************************************************
*                                                                             *
*  Paramètres  : func = instance d'objet GLib à traiter.                      *
*                                                                             *
*  Description : Procède à la libération totale de la mémoire.                *
*                                                                             *
*  Retour      : -                                                            *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

static void g_scan_mime_encoding_function_finalize(GScanMimeEncodingFunction *func)
{
    G_OBJECT_CLASS(g_scan_mime_encoding_function_parent_class)->finalize(G_OBJECT(func));

}


/******************************************************************************
*                                                                             *
*  Paramètres  : -                                                            *
*                                                                             *
*  Description : Constitue une fonction de cernement d'encodages de contenus. *
*                                                                             *
*  Retour      : Fonction mise en place.                                      *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

GRegisteredItem *g_scan_mime_encoding_function_new(void)
{
    GRegisteredItem *result;                /* Structure à retourner       */

    result = g_object_new(G_TYPE_SCAN_MIME_ENCODING_FUNCTION, NULL);

    return result;

}



/* ---------------------------------------------------------------------------------- */
/*                       IMPLEMENTATION DES FONCTIONS DE CLASSE                       */
/* ---------------------------------------------------------------------------------- */


/******************************************************************************
*                                                                             *
*  Paramètres  : item = élément d'appel à consulter.                          *
*                                                                             *
*  Description : Indique le nom associé à une expression d'évaluation.        *
*                                                                             *
*  Retour      : Désignation humaine de l'expression d'évaluation.            *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

static char *g_scan_mime_encoding_function_get_name(const GScanMimeEncodingFunction *item)
{
    char *result;                           /* Désignation à retourner     */

    result = strdup("mime_encoding");

    return result;

}


/******************************************************************************
*                                                                             *
*  Paramètres  : item  = élément d'appel à consulter.                         *
*                args  = liste d'éventuels arguments fournis.                 *
*                count = taille de cette liste.                               *
*                ctx   = contexte de suivi de l'analyse courante.             *
*                scope = portée courante des variables locales.               *
*                out   = zone d'enregistrement de la résolution opérée. [OUT] *
*                                                                             *
*  Description : Réduit une expression à une forme plus simple.               *
*                                                                             *
*  Retour      : Réduction correspondante, expression déjà réduite, ou NULL.  *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

static bool g_scan_mime_encoding_function_run_call(GScanMimeEncodingFunction *item, GScanExpression **args, size_t count, GScanContext *ctx, GScanScope *scope, GObject **out)
{
    bool result;                            /* Bilan à retourner           */
    magic_t cookie;                         /* Référence des bibliothèques */
    GBinContent *content;                   /* Contenu à manipuler         */
    vmpa2t pos;                             /* Tête de lecture             */
    phys_t size;                            /* Quantité de données dispos. */
    const bin_t *data;                      /* Accès à des données         */
    const char *desc;                       /* Description du contenu      */
    sized_string_t string;                  /* Description à diffuser      */

    result = (count == 0);
    if (!result) goto exit;

    cookie = get_magic_cookie(MAGIC_MIME_ENCODING);

    content = g_scan_context_get_content(ctx);

    g_binary_content_compute_start_pos(content, &pos);

    size = g_binary_content_compute_size(content);

    data = g_binary_content_get_raw_access(content, &pos, size);

    desc = magic_buffer(cookie, data, size);

    if (desc != NULL)
    {
        string.data = (char *)desc;
        string.len = strlen(desc);
    }
    else
    {
        string.data = "";
        string.len = 0;
    }

    *out = G_OBJECT(g_scan_literal_expression_new(LVT_STRING, &string));

    g_object_unref(G_OBJECT(content));

 exit:

    return result;

}
