tgt man page points to non existent example config file

Bug #1863527 reported by Rafael David Tinoco
10
This bug affects 1 person
Affects Status Importance Assigned to Milestone
tgt (Ubuntu)
Confirmed
Low
Unassigned

Bug Description

tgt-admin man page says:

"""
FILES
       /etc/tgt/targets.conf
           Configuration file for tgt-admin.

       /usr/share/doc/tgt/targets.conf.example
           Example configuration file for tgt-admin.
"""

at the end BUT:

1) /etc/tgt/targets.conf is empty

2) /usr/share/doc/tgt/targets.conf.example does not exist in any package as it seems.

Changed in tgt (Ubuntu):
status: New → Confirmed
importance: Undecided → Medium
assignee: nobody → Rafael David Tinoco (rafaeldtinoco)
Revision history for this message
Christian Ehrhardt  (paelzer) wrote :

1) isn't empty
on B/F for me it contains:
root@b:~# cat /etc/tgt/targets.conf
# Empty targets configuration file -- please see the package
# documentation directory for an example.
#
# You can drop individual config snippets into /etc/tgt/conf.d
include /etc/tgt/conf.d/*.conf

2. also the example exists, it just got auto-compressed by dh* tools
root@b:~# ll /usr/share/doc/tgt/examples/targets.conf*
-rw-r--r-- 1 root root 2325 Nov 16 2017 /usr/share/doc/tgt/examples/targets.conf.example.gz
-rw-r--r-- 1 root root 3637 Nov 16 2017 /usr/share/doc/tgt/examples/targets.conf.vtl.L700
-rw-r--r-- 1 root root 2879 Nov 16 2017 /usr/share/doc/tgt/examples/targets.conf.vtl.MSL2024

The gain isn't a lot thou:
-rw-r--r-- 1 root root 2.3K Nov 16 2017 /usr/share/doc/tgt/examples/targets.conf.example.gz
-rw-r--r-- 1 root root 7.0K Nov 16 2017 /usr/share/doc/tgt/examples/targets.conf.example

Feel free to flag that this won't be compressed, but it is prio low at best I'd think

Changed in tgt (Ubuntu):
importance: Medium → Low
Revision history for this message
Rafael David Tinoco (rafaeldtinoco) wrote :

Thanks christian, you are right.

I opened this in rush thinking about not forgetting it when doing the fixes after the freeze.

/usr/share/doc/tgt/examples/targets.conf.example <- here you go, as you said!

Not sure I should worry about changing the man page about it or not. In this case, for example, it is in "/usr/share/doc/tgt/examples/targets.conf.example" and not in "/usr/share/doc/tgt/targets.conf.example" BUUUUT I bet there might be tons of other similar cases like this.

I thought the .conf.example file was important because it gives pretty much everything you need to create a config file from the ground, including ACLs, backing drivers, scsi disk vpds, etc...

Changed in tgt (Ubuntu):
assignee: Rafael David Tinoco (rafaeldtinoco) → nobody
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.