NLMCONV(1)

💖 NLMCONV(1) — the glow-up edition 💖

okay bestie, listen up: this is nlmconv, living in the GNU Development Tools corner of your filesystem, and she is literally here to turn object code into an NLM. no cap.

✨ NAME ✨

nlmconv — converts object code into an NLM. that's the whole job description, she's focused, she's got main character energy 🎀

✨ SYNOPSIS ✨

nlmconv [-I bfdname|--input-target=bfdname]
        [-O bfdname|--output-target=bfdname]
        [-T headerfile|--header-file=headerfile]
        [-d|--debug] [-l linker|--linker=linker]
        [-h|--help] [-V|--version]
        infile outfile

✨ DESCRIPTION ✨

so here's the tea 🍓: nlmconv converts the relocatable i386 object file infile into the NetWare Loadable Module outfile, and if you want, it'll also read headerfile for NLM header information. cute, right?

now, for instructions on writing the NLM command file language used in header files — and bestie, you're gonna wanna hear this — go look at the linkers section, NLMLINK in particular, of the NLM Development and Tools Overview, which is part of the NLM Software Developer's Kit (that's the "NLM SDK" to you and me 🫶), available from Novell, Inc.

and plot twist: nlmconv uses the GNU Binary File Descriptor library to read infile. yes ma'am, that's the BFD doing the heavy lifting 💅

💡 also?? nlmconv can perform a link step. like, in other words: you can list more than one object file for input — if you list them in the definitions file (rather than simply specifying one input file on the command line, which is the basic way). and in that case? nlmconv calls the linker for you. she's doing the most, and honestly, we love that for her. 🔥

✨ OPTIONS ✨

• -I bfdname, --input-target=bfdname — object format of the input file. nlmconv can usually just clock the format of a given file on her own, so no default is necessary. she's perceptive like that ✨
• -O bfdname, --output-target=bfdname — object format of the output file. nlmconv infers the output format based on the input format — e.g. for an i386 input file, the output format is nlm32-i386. she's connecting the dots fr fr 🦋
• -T headerfile, --header-file=headerfile — reads headerfile for NLM header information. and for instructions on writing the NLM command file language used in header files, see see the linkers section, of the NLM Development and Tools Overview, which is part of the NLM Software Developer's Kit, available from Novell, Inc. 💜
• -d, --debug — displays (on standard error) the linker command line used by nlmconv. very much "not me peeking at the receipts" energy 🙈
• -l linker, --linker=linker — use linker for any linking. and linker can be an absolute or a relative pathname, your call bestie 🎀
• -h, --help — prints a usage summary. the "hi hello what is this" button ✨
• -V, --version — prints the version number for nlmconv. she's introducing herself 💅
• @file — read command-line options from file. the options read are inserted in place of the original @file option. and okay, important caveat: if file does not exist, or cannot be read, then the option will be treated literally, and not removed. no silent vanishing, no cap.

options in file are separated by whitespace. a whitespace character may be included in an option by surrounding the entire option in either single or double quotes. any character (including a backslash) may be included by prefixing the character to be included with a backslash. and the file may itself contain additional @file options — any such options will be processed recursively 🔥 (yes, it's giving inception, and yes, it slays)

✨ SEE ALSO ✨

• the Info entries for binutils 👑

✨ COPYRIGHT ✨

Copyright (c) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.

permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. a copy of the license is included in the section entitled "GNU Free Documentation License". periodt. 💅

and that's the whole page, bestie!! 🫶 this lil beauty is from binutils-2.21.1, dated 2011-06-27 — a true vintage icon, still serving 💖✨🎀🦋🌸 go convert something and slay 👑