From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-pl1-x62a.google.com (mail-pl1-x62a.google.com [IPv6:2607:f8b0:4864:20::62a]) by sourceware.org (Postfix) with ESMTPS id 82FFE385841F for ; Thu, 24 Feb 2022 18:32:01 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 82FFE385841F Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=rivosinc.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=rivosinc.com Received: by mail-pl1-x62a.google.com with SMTP id ay3so2568982plb.1 for ; Thu, 24 Feb 2022 10:32:01 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=rivosinc-com.20210112.gappssmtp.com; s=20210112; h=subject:date:message-id:mime-version:content-transfer-encoding:cc :from:to; bh=IN1T3/k0cBTunQfDFHsxRCjP4ViYY9md/9UnWAILAbQ=; b=fCySyl/fdlmAGLHsjvcEfctRLTFy+mlIm215KPyawbdLxtyahP+5wJKIyA/zdaCBsg wYXAQLKjRlIT9lW7/D5/2fvEWz1n9OiieCdtrjN2c9djJJRXu8HtXfI3v3Oyjvr7X8iT p2Mxx6cflTw82H9RmiEkI2hTy+2GE2hM7mxbMFnAu7nfu+dwcJpMmVECx05j+xLVX67C nv4GaDhXlBlbAlPxsihvoXMeTiK93326/3sNx9cpTUIiY09UeOZ7KYN3arUvsQcQRQYq teH7hxEN9Bw8mHbx6R09aJDl3++i32a/jKaqxmNZBC6k6ElgU3+Z9hvStVy/gy7+I93A RNSQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:subject:date:message-id:mime-version :content-transfer-encoding:cc:from:to; bh=IN1T3/k0cBTunQfDFHsxRCjP4ViYY9md/9UnWAILAbQ=; b=r9ocSbuiryeKxaD15lx/dA8WZgGAn6qjuDnJj7/TpAIfmBwWeFN8xiQTFptICQv39C vV6k0G4dVNn1BWsy+LUm4/c1m7P+MTFtvCbHe4Zq4qG20yP+x7Kz5ik9zfsKnlOuPZVv yJjlSehUfSR5tfGoXdkeaZPukEMgcnA1QJSv6w3bR+y2BYmQt8vpBqQhiHjjpQ6H5Via y4FRVURPzIh7I4hobakjpqNSB/OZlNbl059D4JGMWqBdpUBSgH+A9N0uY//jVF2HX7mU l3qlXUfm/6XoG4bxu2J6Rqzzjh1x/bqand6u/w77x2l08J6LqkVY5IK8guuGe/AKiyA9 thWg== X-Gm-Message-State: AOAM532FF3EQ1lgP5XA/Bj3uMXoGKScaQtefPrZNpEUtn/xxhEVSuGEX ASHPtEz3BRwSp4s1X/by4LakBlFYV0MCPw== X-Google-Smtp-Source: ABdhPJxijy2bQWAouHTix/vOaVk+KmE6p5CpR8JilHsPnhINsP5jPGBig8zPEBOo0H/T1fQs2L+M4Q== X-Received: by 2002:a17:902:f64e:b0:14d:20db:8478 with SMTP id m14-20020a170902f64e00b0014d20db8478mr3832079plg.158.1645727520603; Thu, 24 Feb 2022 10:32:00 -0800 (PST) Received: from localhost ([12.3.194.138]) by smtp.gmail.com with ESMTPSA id g5-20020a63fa45000000b0037407b6ffdasm236101pgk.5.2022.02.24.10.32.00 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 24 Feb 2022 10:32:00 -0800 (PST) Subject: [PATCH v1] binutils/doc: Document the RISC-V -M options Date: Thu, 24 Feb 2022 10:30:46 -0800 Message-Id: <20220224183046.13473-1-palmer@rivosinc.com> X-Mailer: git-send-email 2.34.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit From: Palmer Dabbelt To: binutils@sourceware.org X-Spam-Status: No, score=-12.2 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, GIT_PATCH_0, RCVD_IN_DNSWL_NONE, SPF_HELO_NONE, SPF_PASS, TXREP, T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on server2.sourceware.org X-BeenThere: binutils@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Binutils mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 24 Feb 2022 18:32:02 -0000 These have been around for quite a while now, but we forgot to actually document them. * doc/binutils.texi (-M): New section on RISC-V options. Signed-off-by: Palmer Dabbelt --- binutils/doc/binutils.texi | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/binutils/doc/binutils.texi b/binutils/doc/binutils.texi index 288974be386..bfb5a6199ca 100644 --- a/binutils/doc/binutils.texi +++ b/binutils/doc/binutils.texi @@ -2693,6 +2693,19 @@ rather than names, for the selected types of registers. You can list the available values of @var{ABI} and @var{ARCH} using the @option{--help} option. +For RISC-V, this option controls how instructions are disassembled. This +option can be provided multiple times, each time with a comma separated list +containing one or more of the following entries: + +@table @code +@item no-aliases +Avoid printing pseudo instruction mnemonics. + +@item numeric +Use numeric register names (ie, x1) instead of ABI register names (ie, ra) when +printing instructions. +@end table + For VAX, you can specify function entry addresses with @option{-M entry:0xf00ba}. You can use this multiple times to properly disassemble VAX binary files that don't contain symbol tables (like -- 2.34.1