XEN-CREATE-NFS(8)

✨ NAME ✨

xen-create-nfs — okay bestie, this is the little script (it's a Perl one, from the xen-create-nfs family, and yes it lives in section 8 of the manual) that whips up a Xen config file for a guest whose root is an NFS mount. It literally just makes the config file. That's the whole vibe. 💅

---

🌸 SYNOPSIS 🌸

xen-create-nfs [options]

Help Options:
 --help     Show help information.
 --manual   Read the manual for this script.
 --version  Show the version information and exit.
 --verbose  Show diagnostic output.

Networking Options:
 --broadcast  The broadcast address to use when configured with a static IP.
 --dhcp       Configure the guest to use DHCP for IP allocation.
 --gateway    The gateway address to use when configured with a static IP.
 --hostname   The hostname to configure for the guest.
 --ip         The IP address to use when configured with a static IP.
 --netmask    The netmask address to use when configured with a static IP.
 --nameserver The nameserver to use when configured with a static IP.

General options:
 --admins     Specify which users should be setup as xen-shell admins.
 --force      Force the overwriting of an existing configuration file.
 --initrd     Specify the initial ramdisk for the guest.
 --kernel     Specify the kernel to use for the guest.
 --memory     Specify the memory to allocate for this guest.
 --mac        Specify the MAC address to use for the guest.
 --template   Specify an alternative template file to use.

NFS options:
 --nfs_server Specify the NFS server to mount the root partition from.
 --nfs_root   Specify the path, upon the NFS server, to mount.

---

🎀 OPTIONS 🎀

Short and sweet list, no cap:

• --help — shows you the help information. ur little flashlight in the dark 🫶
• --hostname — specify the hostname to delete. (Yes, delete. That's what it says. I'm just the messenger, bestie 😭)
• --manual — read the manual for this script. very meta of it, iconic behavior honestly
• --version — show the version number and exit. peace out ✌️

---

🦋 DESCRIPTION 🦋

xen-create-nfs is a simple script, and the way that it's simple is genuinely the point. It lets you easily create a single configuration file for a Xen guest that's gonna mount its remote filesystem over an NFS root. One file. That's it. ✨

It does not create any images to use for local storage — none, zero, don't ask — and it doesn't support more than the minimal number of options needed to complement the existing xen-create-image script. But it is, hopefully, useful. 💖

---

🌈 REFERENCE 🌈

Wanna know more about what you'll actually need to support NFS-root Xen guests? The author wrote an article about it, and it might be useful:

https://debian-administration.org/articles/505

Go read it, it's giving "primary source" energy. 📚

---

👑 AUTHORS 👑

The legends responsible:

• Steve Kemp, https://steve.fi/
• Stephane Jourdois

---

💜 LICENSE 💜

Copyright (c) 2005-2009 by Steve Kemp, (c) 2010 by The Xen-Tools Development Team. All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. The LICENSE file contains the full text of the license.

Real talk, bestie: the license stuff stays exactly as-is. Read the LICENSE file for the whole thing. 🫶

---

And that's the whole page, fr fr 💅 This was xen-create-nfs, version 4.9.2, from the Perl Programmers Reference Guide, dated 2023-02-06 — mwah, slay, go mount something over NFS. 🧚✨