Difference between revisions of "Manjaro-tools/en"

Updating to match new version of source page
(Updating to match new version of source page)
 
(Updating to match new version of source page)
Tags: Mobile web edit Mobile edit
 
Line 17: Line 17:
= Configuration =
= Configuration =


manjaro-tools can be configured by copying the folder ''/etc/manjaro-tools'' to your home in ''~/.config'' folder and then edit the file {{ic|''./config/manjaro-tools/manjaro-tools.conf''}}
manjaro-tools can be configured by copying the folder ''/etc/manjaro-tools'' to your home in ''~/.config'' folder and then edit the file {{ic|''~/.config/manjaro-tools/manjaro-tools.conf''}}
 


= Files =
= Files =
Line 38: Line 37:
The help looks like the following:
The help looks like the following:


  $ buildset -h
  {{UserCmdOutput|command=buildset -h|result=
<pre>
  Usage: buildset [options]
  Usage: buildset [options]
     -c <name>  Create set
     -c <name>  Create set
Line 46: Line 46:
     -q          Query sets
     -q          Query sets
     -h          This help
     -h          This help
</pre>
}}


{{Note|The set name should be different from a directory name in pkgbuilds dir. Anything else should work, eg adding a date to the name.}}
{{Note|The set name should be different from a directory name in pkgbuilds dir. Anything else should work, eg adding a date to the name.}}


= buildpkg =
= buildpkg =
Line 59: Line 60:
The help looks like the following:
The help looks like the following:


  Usage: buildpkg [options]
  {{UserCmdOutput|command=buildpkg -h|result=
<pre>
Usage: buildpkg [options]
     -a <arch>          Arch [default: x86_64]
     -a <arch>          Arch [default: x86_64]
     -b <branch>        Branch [default: stable]
     -b <branch>        Branch [default: stable]
Line 72: Line 75:
     -s                Sign packages
     -s                Sign packages
     -w                Clean up cache and sources
     -w                Clean up cache and sources
</pre>
}}


To build a single package, go into the directory which is one above the package build directory (which contains the PKGBUILD), and run it as:
To build a single package, go into the directory which is one above the package build directory (which contains the PKGBUILD), and run it as:


  buildpkg -p <package-name>
  {{UserCmd|command=buildpkg -p package-name}}


To build a set the name of the set can be used. The current sets can be queried with the {{ic|-q}} option.
To build a set the name of the set can be used. The current sets can be queried with the {{ic|-q}} option.


= buildtree =
= buildtree =
Line 86: Line 90:
The arguments are:
The arguments are:


  $ buildtree -h
  {{UserCmdOutput|command=buildtree -h|result=
<pre>
  Usage: buildtree [options]
  Usage: buildtree [options]
     -s            Sync manjaro tree
     -s            Sync manjaro tree
Line 93: Line 98:
     -q            Query settings
     -q            Query settings
     -h            This help[/code]
     -h            This help[/code]
</pre>
}}


To sync Arch and Manjaro trees:
To sync Arch and Manjaro trees:


  buildtree -as
  {{UserCmd|command=buildtree -as}}
 


= buildiso =
= buildiso =
Line 110: Line 116:
The help looks like the following for x86_64:
The help looks like the following for x86_64:


$ buildiso -h
{{UserCmdOutput|command=buildiso -h|result=
<pre>
  Usage: buildiso [options]
  Usage: buildiso [options]
     -p <profile>      Buildset or profile [default: default]
     -p <profile>      Buildset or profile [default: default]
Line 126: Line 133:
     -q                Query settings and pretend build
     -q                Query settings and pretend build
     -h                This help
     -h                This help
 
</pre>
}}


== Query Building ==
== Query Building ==
Line 132: Line 140:
To query build an ISO ('''-q''' option), for example the xfce-openbox-openrc profile, the following command can be used:
To query build an ISO ('''-q''' option), for example the xfce-openbox-openrc profile, the following command can be used:


{{UserCmdOutput|command=buildiso -p xfce -qv|result=
<pre>
<pre>
~ >>> buildiso -p xfce -qv                                                         
[sudo] password for fh:
==> manjaro-tools
==> manjaro-tools
   -> version: 0.15.9
   -> version: 0.15.9
Line 178: Line 185:
   -> disable_systemd: pacman-init
   -> disable_systemd: pacman-init
</pre>
</pre>
 
}}


== Building ==
== Building ==
Line 184: Line 191:
To actually build the ISO:
To actually build the ISO:


  $ buildiso -p xfce -b stable
  {{UserCmd|command=buildiso -p xfce -b stable}}
 


== Building with predownloaded Xorg packages ==
== Building with predownloaded Xorg packages ==
Line 191: Line 197:
To build an ISO while retaining the previously downloaded cache of Xorg packages, the '''-x''' option can be used:
To build an ISO while retaining the previously downloaded cache of Xorg packages, the '''-x''' option can be used:


$ buildiso -p xfce-openbox-openrc/ -b stable -x
  {{UserCmd|command=buildiso -p xfce-openbox-openrc/ -b stable -x}}
 


== Building with a small config change ==
== Building with a small config change ==
Line 200: Line 205:
Supposing something only changed in config, like a setting, instead of building the whole ISO from scratch, the ISO build directory can be modified and the ISO can be rebuilt. For example, supposing one changed ''xfce-overlay/etc/skel/.conkyrc'' in the config, one can go into the work directory, modify the said file, and rebuild the ISO using the '''-cs''' option.
Supposing something only changed in config, like a setting, instead of building the whole ISO from scratch, the ISO build directory can be modified and the ISO can be rebuilt. For example, supposing one changed ''xfce-overlay/etc/skel/.conkyrc'' in the config, one can go into the work directory, modify the said file, and rebuild the ISO using the '''-cs''' option.


The work directory can be found using the '''-''' option:
The work directory can be found using the '''-h''' option:


  ~ >>> buildiso -h                                                                                  
  {{UserCmdOutput|command=buildiso -h|result=                 
<pre>
  Usage: buildiso [options]
  Usage: buildiso [options]
     -p <profile>      Buildset or profile [default: default]
     -p <profile>      Buildset or profile [default: default]
Line 226: Line 232:
     -q                Query settings and pretend build
     -q                Query settings and pretend build
     -h                This help
     -h                This help
</pre>
}}


    -r <dir>          Chroots directory
                        [default: '''/var/lib/manjaro-tools/buildiso''']
(work directory highlighted in bold)
(work directory highlighted in bold)


The required file can be edited as root, for example:
The required file can be edited as root, for example:
$ sudo nano /var/lib/manjaro-tools/buildiso/xfce/x86_64/desktopfs/etc/skel/.conkyrc
{{UserCmd|command=sudo nano /var/lib/manjaro-tools/buildiso/xfce/x86_64/desktopfs/etc/skel/.conkyrc}}


There is a catch involved here though; the file one wants to edit may be present in multiple images, like rootfs, livefs, desktopfs), and would need to be edited in the respective image directories.
There is a catch involved here though; the file one wants to edit may be present in multiple images, like rootfs, livefs, desktopfs), and would need to be edited in the respective image directories.
Line 237: Line 246:


Then the ISO then can be rebuilt as:
Then the ISO then can be rebuilt as:
$ buildiso -p xfce -cs
{{UserCmd|command=buildiso -p xfce -cs}}
 


=== Alternative ===
=== Alternative ===
Line 246: Line 254:
For example:
For example:


  $ buildiso -p xfce -b stable -x
  {{UserCmdOutput|command=buildiso -p xfce -b stable -x|result=
<pre>
==> Start building [xfce]
==> Start building [xfce]
==> Cleaning up ...
==> Cleaning up ...
   -> Deleting chroot [rootfs] (x86_64) ...
   -> Deleting chroot [rootfs] (x86_64) ...
   -> Deleting isoroot [iso] ...
   -> Deleting isoroot [iso] ...
...
[..]
...
</pre>
}}


After this the changes in the work directory can be made, and the ISO can be generated with:
After this the changes in the work directory can be made, and the ISO can be generated with:


  $ buildiso -p xfce/ -cz
  {{UserCmd|command=buildiso -p xfce/ -cz}}


= See Also =
= See Also =
8,560

edits