verimg

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 15 Open GitHub ↗

Tool for creating customized FreeBSD VM image(s) and also for unattended installation of PKGBASE based FreeBSD system.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# verimg(8)

Tool for creating customized FreeBSD VM image(s) and also for unattended installation of PKGBASE based FreeBSD system.

These are the `verimg(8)` options.

```
FreeBSD # verimg -h
usage:
  verimg: [OPTION(s)]

options:
  -f FILE  which file to use for VM image (default: VERIMG)
  -s SIZE  size of VM image (default: 10g)
  -r VERS  which FreeBSD version to use (default: releng/15.0)
  -i LIST  colon (:) separated packages list to install (default: beadm:lsblk)
  -m MNTD  mount directory for installation (default: /mnt)
  -S SRCD  directory for FreeBSD source (default: /usr/src)
  -p POOL  specify ZFS pool name (default: sys)
  -b BRCH  specify branch for pkg(8) (default: latest)
  -n       display options and exit
  -k LIST  list of kernel configs to build in CONF1:CONF2:CONF3 format
           if unspecified then only the GENERIC kernel will be built
  -t TYPE  type of operation is one of options:
           = img
             - create FILE backend and do setup there (default)
           = mnt
             - do not use FILE backend and just setup at mount dir
  -R REPO  dir where PKGBASE packages are located
           (default: /usr/obj/usr/src/repo/FreeBSD:15:amd64/latest)
  -M MODE  mode in which 'verimg' to start:
           = fetch:build:setup (default)
             - fetch FreeBSD sources with git(1) clone into /usr/src
             - build FreeBSD from sources from /usr/src in /usr/obj
             - setup FreeBSD from /usr/obj PKGBASE repository
           = build:setup
             - build FreeBSD from sources from /usr/src in /usr/obj
             - setup FreeBSD from /usr/obj PKGBASE repository
           = setup
             - setup FreeBSD from /usr/obj PKGBASE repository

examples:
  # verimg.sh -n -M setup -s 20g -r releng/15.0 -i lsblk:beadm:python:ansible
  INFO: options that will be used
    ARG_MODE: setup
    ARG_TYPE: img
    ARG_FILE: VERIMG
    ARG_SIZE: 20g
    ARG_VERS: releng/15.0
    ARG_INST: beadm:lsblk:python:ansible
    ARG_MNTD: /mnt
    ARG_SRCD: /usr/src
    ARG_KERN: GENERIC
    ARG_POOL: sys
    ARG_REPO: /usr/obj/usr/src/repo/FreeBSD:15:amd64/latest
    ARG_BRCH: latest

cleanup:
  verimg(8) takes care to clean up (unmount/export/...) after job is done/fail
  but if for some reason it does not clean up properly - use this manual way
    # umount -f /mnt/dev
    # zpool export -f sys
    # mdconfig -d -u /dev/md0

md(4) device may be other then /dev/md0 so check with mdconfig(8) command
    # mdconfig -l -v
    md0     vnode      10G  /home/vermaden/VERIMG   -
```

Steps like 'Fetch' and 'Build' are optional.

You can even use this tool for unattended automated FreeBSD installation on bare metal ... or a laptop.

By default `verimg(8)` fetches the FreeBSD sources ... builds `world`/`kernel` and then PKGBASE packages ... and installs new FreeBSD from local PKGBASE repo in <tt><b>VERIMG</b></tt> file ... but you can easily overwrite these with options ... and check what will be done with dry run `-n` option too.

Here are the defaults printed.

```
FreeBSD # verimg -n
INFO: options that will be used
  ARG_MODE: fetch:build:setup
  ARG_TYPE: img
  ARG_FILE: VERIMG
  ARG_SIZE: 10g
  ARG_VERS: releng/15.0
  ARG_INST: beadm:lsblk
  ARG_MNTD: /mnt
  ARG_SRCD: /usr/src
  ARG_KERN: GENERIC
  ARG_POOL: sys
  ARG_REPO: /usr/obj/usr/src/repo/FreeBSD:15:amd64/latest
  ARG_BRCH: latest
```

Here is example `verimg(8)` run for unattended FreeBSD install in `VERIMG` file when FreeBSD sources were fetched earlier and `world`/`kernel` are already build with PKGBASE repo.

```
FreeBSD # verimg -M setup -t img
INFO: options that will be used
  ARG_MODE: setup
  ARG_TYPE: img
  ARG_FILE: VERIMG
  ARG_SIZE: 10g
  ARG_VERS: releng/15.0
  ARG_INST: beadm:lsblk
  ARG_MNTD: /mnt
  ARG_SRCD: /usr/src
  ARG_KERN: GENERIC
  ARG_POOL: sys
  ARG_REPO: /usr/obj/usr/src/repo/FreeBSD:15:amd64/latest
  ARG_BRCH: latest
```

Have fun.

verimg

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README