diff --git a/srcpkgs/base-files/files/vkpurge.8 b/srcpkgs/base-files/files/vkpurge.8 new file mode 100644 index 00000000000..4ea9633b516 --- /dev/null +++ b/srcpkgs/base-files/files/vkpurge.8 @@ -0,0 +1,62 @@ +.Dd July 24, 2016 +.Dt VKPURGE 8 +.Os +.Sh NAME +.Nm vkpurge +.Nd remove old kernel files/modules +.Sh SYNOPSIS +.Nm +.Cm list +.Nm +.Cm rm +.Op Ar versions\ ... | Cm all +.Sh DESCRIPTION +The +.Nm +command is used to properly remove old or unwanted kernels from an +x86-based Void Linux system, by running the appropiate removal hooks +and doing the removal. +.Ss Justification +.Xr xbps-install 1 +will leave old kernels in place when the kernel package gets upgraded, and +.Xr xbps-remove 1 +will only be able to remove the latest kernel in a version, +for example 4.3.4_4, but it would need to leave behind 4.3.4_3. +.Sh OPTIONS +.Bl -tag -width Ds +.It Ic list +Provide a list of installed kernel versions. +.It Ic rm +Remove kernels. +Must be followed by either a version number or the literal +.Sq Ic all . +.El +.Sh EXIT STATUS +.Nm +exits with a 0 code unless the help text was printed. +Since there is no proper invocation to trigger a print of the help, +this can be summarized: if there was a proper invocation of +.Nm +then the command will exit 0. +Otherwise, the exit code is 1. +.Sh EXAMPLES +The following will list all installed kernels. +.Bd -literal -offset indent +$ vkpurge list +.Ed +.Pp +The following command will delete the kernel version 2.6.39_2 with all +kernel-specific files such as compiled modules. +.Bd -literal -offset indent +# vkpurge rm 2.6.39_2 +.Ed +.Pp +The following command will delete the kernels with version 2.6.39_2 and 4.3.4_1 +.Bd -literal -offset indent +# vkpurge rm 2.6.39_2 4.3.4_1 +.Ed +.Sh SEE ALSO +.Xr xbps-install 1 , +.Xr xbps-remove 1 +.Sh BUGS +There is no support as of yet for non-x86 platforms. diff --git a/srcpkgs/base-files/template b/srcpkgs/base-files/template index 74a60393665..dd0a421ffa9 100644 --- a/srcpkgs/base-files/template +++ b/srcpkgs/base-files/template @@ -1,7 +1,7 @@ # Template file for 'base-files' pkgname=base-files version=0.139 -revision=1 +revision=2 bootstrap=yes depends="xbps-triggers" short_desc="Void Linux base system files" @@ -64,6 +64,8 @@ do_install() { # vkpurge vbin ${FILESDIR}/vkpurge + vman ${FILESDIR}/vkpurge.8 + vbin ${FILESDIR}/lsb_release # Install default dracut configuration.