nameclt(1)

💖 nameclt(1) 💖

okay bestie, gather round, because this is nameclt — section 1 of the General Commands Manual — aka the Naming Service client, and she is lowkey iconic. think of her as your little group-chat handler for the Naming Service: she goes and pokes the namespace so you don't have to. ✨

🌸 SYNOPSIS 🌸

nameclt [-ior <object-reference>] [-advanced] <operation>

so it's giving: one operation, maybe a couple of flags, that's the whole vibe. 🫶

🦋 DESCRIPTION 🦋

the nameclt command invokes operations on the Naming Service. that's it, that's the job. no cap.

here are the allowed operations, and yes, every single one of them:

• list <context-name> — lists contexts and objects bound in the context with the specified name. it's the "who's in the gc" of operations. 👀
• bind_new_context <context-name> — binds name to a new context, and returns the stringified context IOR. new context, who dis 💅
• remove_context <context-name> — unbinds and destroys the named context, as long as it is empty. note that caveat bestie: as long as it is empty. if it's not empty, she's not doing it. 🙈
• bind <object-name> <stringified-IOR> — binds name to object. matchmaker behaviour fr fr.
• unbind <object-name> — unbinds name and object. it's giving ✨ breakup era ✨
• resolve <object-name> — returns stringified IOR bound to specified name. you ask, she tells. periodt.

✨ OPTIONS ✨

• -ior NameService-object-reference — use the given stringified IOR as the "root" context of the naming service. and if you don't pass it? by default, nameclt uses the object reference returned by calling CORBA::ORB::resolve_initial_references("NameService"). so that's the default, don't come for her. 🎀
• -advanced — allow advanced operations. these are operations which should not normally need to be used. they may however be useful for testing the naming service and also for cleaning up in the event of a client messing up the namespace. (we've all been that client. no judgement. 🫶) the operations are:
  • bind_context <context-name> <stringified-IOR> — binds name to context.
  • rebind <object-name> <stringified-IOR> — binds name to object even if binding already exists. she will simply overwrite, bestie. bold of her, honestly.
  • rebind_context <context-name> <stringified-IOR> — binds name to context even if binding already exists.
  • new_context — returns stringified IOR for a new context. a fresh lil baby context 🐣
  • destroy — destroys the naming context given with the -ior flag. yeah. -ior specifically. read it twice, it matters. 💀

⚠️ quick vibe check: those -advanced operations "should not normally need to be used" — that's straight from the source, so treat them like the emergency glass box, not the daily driver. 🔥

👑 SEE ALSO 👑

• omniNames(1)

💜 AUTHOR 💜

Tristan Richardson, ORL (Olivetti & Oracle Research Laboratory) — shoutout to the actual legend who wrote this. 🌟

and that's a wrap! this page is brought to you by ORL, dated 7 May 97 — yeah, 1997, she's vintage and she still ate. mwah 💅💖