FCRLS(8)

💖 FCRLS 💖

okay bestie, sit down, hydrate, and let me tell you about fcrls — a little icon from the Open-FCoE Tools collection, living its best life in section 8 of your manual (that's the admin/system tools section, iykyk). it's giving "I read link error status blocks for breakfast" energy and honestly? we're obsessed. 🦋

✨ NAME ✨

fcrls — the Fibre Channel Read Link Error Status Block (RLS) tool. that's it, that's the whole vibe. 🌸

✨ SYNOPSIS ✨

fcrls --port rport_bsg_name [--quiet]

fcrls --fcid rport_port_FC-ID [--quiet]

fcrls --help

look at her. three little ways in, and --quiet tagging along like a plus-one who knows when to stop talking. 🎀

✨ DESCRIPTION ✨

so here's the tea, bestie: fcrls performs a Fibre Channel Read Link Error Status Block (RLS) ELS request — that's Extended Link Service for anyone keeping score, and you can peek at the specs in FC-LS-2 — and it does this via BSG over a given rport bsg name or an FC-ID. pick your fighter. 💅

fcrls takes either a rport bsg name or a rport port FC-ID as the input. that's the whole input situation, no secret third thing. 🙈

and when you want it to stop narrating its life to you? hit it with the --quiet option and verbose output is ✨disabled✨. periodt.

✨ OPTIONS ✨

• --port rport_bsg_name — sends the RLS to a rport, addressed by its FC remote port bsg name. example-flavored: rport-7:0-1. 👑
• --fcid rport_port_FC-ID — sends the RLS to a rport, addressed by its port FC-ID instead. example-flavored: 0xce000d. 🦋
• --quiet — disables verbose output. she's not here to chat, she's here to work. 💀
• --help — shows you a help message with the basic usage instructions. the "read me first, bestie" of flags. 🫶

✨ EXAMPLES ✨

sends RLS to the FC remote port as rport-7:0-1:

fcrls --port rport-7:0-1

sends RLS to the FC remote port with 0xce000d as its port FC-ID:

fcrls --fcid 0xce000d

copy, paste, slay. no notes. ⭐

✨ SEE ALSO ✨

• fcoeadm(8) — go say hi, she's the neighbor 🧚

✨ SUPPORT ✨

fcrls is part of the fcoe-utils package, maintained through the Open-FCoE project. resources for both developers and users can be found at the Open-FCoE website, http://open-fcoe.org/ — that's the link, no gatekeeping here. 🌈

lowkey important: this whole thing is the Open-FCoE release, dated 02/06/2013. yes, she's vintage, and yes, vintage is iconic. take care of her and she'll take care of your link error status blocks. 🎀💖