rasm.c

Go to the documentation of this file.

/*
 * Copyright (C) 2026 Ramiro Polla
 *
 * This file is part of FFmpeg.
 *
 * FFmpeg is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * FFmpeg 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
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with FFmpeg; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 */
 
#include "rasm.h"
 
#include <stdarg.h>
 
#include "libavutil/error.h"
#include "libavutil/macros.h"
#include "libavutil/mem.h"
 
/*********************************************************************/
/* Main runtime assembler context */
 
RasmContext *rasm_alloc(void)
{
    return av_mallocz(sizeof(RasmContext));
}
 
void rasm_free(RasmContext **prctx)
{
    if (!prctx || !*prctx)
        return;
 
    RasmContext *rctx = *prctx;
    for (int i = 0; i < rctx->num_entries; i++) {
        RasmEntry *entry = &rctx->entries[i];
        RasmNode *node = entry->start;
        while (node != NULL) {
            switch (node->type) {
            case RASM_NODE_COMMENT:
                av_freep(&node->comment.text);
                break;
            case RASM_NODE_DIRECTIVE:
                av_freep(&node->directive.text);
                break;
            default:
                break;
            }
            av_freep(&node->inline_comment);
            RasmNode *current_node = node;
            node = node->next;
            av_free(current_node);
        }
    }
    av_freep(&rctx->entries);
    for (int i = 0; i < rctx->num_labels; i++)
        av_freep(&rctx->labels[i]);
    av_freep(&rctx->labels);
    av_freep(&rctx->comment_next);
    av_freep(prctx);
}
 
/*********************************************************************/
/* IR Nodes */
 
static RasmNode *add_node(RasmContext *rctx, RasmNodeType type)
{
    if (rctx->error)
        return NULL;
 
    RasmNode *node = av_mallocz(sizeof(RasmNode));
    if (!node) {
        rctx->error = AVERROR(ENOMEM);
        return NULL;
    }
 
    node->type = type;
 
    if (rctx->current_node) {
        RasmNode *next = rctx->current_node->next;
        node->prev = rctx->current_node;
        node->next = next;
        rctx->current_node->next = node;
        if (next)
            next->prev = node;
    }
 
    rctx->current_node = node;
 
    return node;
}
 
RasmNode *rasm_add_insn(RasmContext *rctx, int id,
                        RasmOp op0, RasmOp op1, RasmOp op2, RasmOp op3)
{
    RasmNode *node = add_node(rctx, RASM_NODE_INSN);
    if (node) {
        node->insn.id        = id;
        node->insn.op[0]     = op0;
        node->insn.op[1]     = op1;
        node->insn.op[2]     = op2;
        node->insn.op[3]     = op3;
        node->inline_comment = rctx->comment_next;
        rctx->comment_next   = NULL;
    }
    return node;
}
 
RasmNode *rasm_add_comment(RasmContext *rctx, const char *comment)
{
    if (rctx->error)
        return NULL;
 
    char *dup = av_strdup(comment);
    if (!dup) {
        rctx->error = AVERROR(ENOMEM);
        return NULL;
    }
 
    RasmNode *node = add_node(rctx, RASM_NODE_COMMENT);
    if (node) {
        node->comment.text = dup;
    } else {
        av_freep(&dup);
    }
    return node;
}
 
RasmNode *rasm_add_commentf(RasmContext *rctx, char *s, size_t n, const char *fmt, ...)
{
    va_list args;
    va_start(args, fmt);
    vsnprintf(s, n, fmt, args);
    va_end(args);
    return rasm_add_comment(rctx, s);
}
 
RasmNode *rasm_add_label(RasmContext *rctx, int id)
{
    RasmNode *node = add_node(rctx, RASM_NODE_LABEL);
    if (node) {
        node->label.id = id;
    }
    return node;
}
 
RasmNode *rasm_add_func(RasmContext *rctx, int id, bool export,
                        bool jumpable)
{
    RasmNode *node = add_node(rctx, RASM_NODE_FUNCTION);
    if (node) {
        av_assert0(id >= 0 && id < rctx->num_labels);
        node->func.name     = rctx->labels[id];
        node->func.export   = export;
        node->func.jumpable = jumpable;
    }
    return node;
}
 
RasmNode *rasm_add_endfunc(RasmContext *rctx)
{
    RasmNode *node = add_node(rctx, RASM_NODE_ENDFUNC);
    return node;
}
 
RasmNode *rasm_add_directive(RasmContext *rctx, const char *text)
{
    if (rctx->error)
        return NULL;
 
    char *dup = av_strdup(text);
    if (!dup) {
        rctx->error = AVERROR(ENOMEM);
        return NULL;
    }
 
    RasmNode *node = add_node(rctx, RASM_NODE_DIRECTIVE);
    if (node) {
        node->directive.text = dup;
    } else {
        av_freep(&dup);
    }
    return node;
}
 
RasmNode *rasm_get_current_node(RasmContext *rctx)
{
    return rctx->current_node;
}
 
RasmNode *rasm_set_current_node(RasmContext *rctx, RasmNode *node)
{
    RasmNode *current_node = rctx->current_node;
    rctx->current_node = node;
    return current_node;
}
 
/*********************************************************************/
/* Top-level IR entries */
 
int rasm_func_begin(RasmContext *rctx, const char *name, bool export,
                    bool jumpable)
{
    if (rctx->error)
        return rctx->error;
 
    /* Grow entries array. */
    RasmEntry *entry = av_dynarray2_add((void **) &rctx->entries,
                                        &rctx->num_entries,
                                        sizeof(*rctx->entries), NULL);
    if (!entry) {
        rctx->error = AVERROR(ENOMEM);
        return rctx->error;
    }
 
    entry->type = RASM_ENTRY_FUNC;
 
    int id = rasm_new_label(rctx, name);
 
    rasm_set_current_node(rctx, NULL);
    entry->start = rasm_add_func(rctx, id, export, jumpable);
    entry->end   = rasm_add_endfunc(rctx);
    rasm_set_current_node(rctx, entry->start);
 
    entry->func.export   = export;
    entry->func.label_id = id;
 
    if (rctx->error)
        return rctx->error;
 
    return id;
}
 
/*********************************************************************/
void rasm_annotate(RasmContext *rctx, const char *comment)
{
    if (rctx->error || !rctx->current_node)
        return;
    RasmNode *current_node = rctx->current_node;
    av_freep(&current_node->inline_comment);
    current_node->inline_comment = av_strdup(comment);
    if (!current_node->inline_comment)
        rctx->error = AVERROR(ENOMEM);
}
 
void rasm_annotatef(RasmContext *rctx, char *s, size_t n, const char *fmt, ...)
{
    va_list args;
    va_start(args, fmt);
    vsnprintf(s, n, fmt, args);
    va_end(args);
    rasm_annotate(rctx, s);
}
 
void rasm_annotate_next(RasmContext *rctx, const char *comment)
{
    if (rctx->error)
        return;
    av_freep(&rctx->comment_next);
    rctx->comment_next = av_strdup(comment);
    if (!rctx->comment_next)
        rctx->error = AVERROR(ENOMEM);
}
 
void rasm_annotate_nextf(RasmContext *rctx, char *s, size_t n, const char *fmt, ...)
{
    va_list args;
    va_start(args, fmt);
    vsnprintf(s, n, fmt, args);
    va_end(args);
    rasm_annotate_next(rctx, s);
}
 
int rasm_new_label(RasmContext *rctx, const char *name)
{
    if (rctx->error)
        return rctx->error;
 
    char *dup = NULL;
    int ret;
 
    if (name) {
        dup = av_strdup(name);
        if (!dup) {
            ret = AVERROR(ENOMEM);
            goto error;
        }
    }
 
    /* Get current label number. */
    ret = rctx->num_labels;
 
    /* Grow labels array. */
    char **p = av_dynarray2_add((void **) &rctx->labels, &rctx->num_labels,
                                sizeof(*rctx->labels), NULL);
    if (!p) {
        ret = AVERROR(ENOMEM);
        goto error;
    }
    *p = dup;
 
error:
    if (ret < 0) {
        av_free(dup);
        rctx->error = ret;
    }
    return ret;
}
 
int rasm_new_labelf(RasmContext *rctx, char *s, size_t n, const char *fmt, ...)
{
    va_list args;
    va_start(args, fmt);
    vsnprintf(s, n, fmt, args);
    va_end(args);
    return rasm_new_label(rctx, s);
}
 
/*********************************************************************/
/* AArch64-specific */
 
void a64op_vec_views(RasmOp op, AArch64VecViews *out)
{
    uint8_t n = a64op_vec_n(op);
    out->b   = a64op_vecb  (n);
    out->h   = a64op_vech  (n);
    out->s   = a64op_vecs  (n);
    out->d   = a64op_vecd  (n);
    out->q   = a64op_vecq  (n);
    out->b8  = a64op_vec8b (n);
    out->b16 = a64op_vec16b(n);
    out->h4  = a64op_vec4h (n);
    out->h8  = a64op_vec8h (n);
    out->s2  = a64op_vec2s (n);
    out->s4  = a64op_vec4s (n);
    out->d2  = a64op_vec2d (n);
    for (int i = 0; i < 2; i++)
        out->be[i] = a64op_elem(out->b, i);
    for (int i = 0; i < 2; i++)
        out->de[i] = a64op_elem(out->d, i);
}