Bug 160609 - Mention LDIF v1 req'd when using :< URL specifier notation in CLI doc
Mention LDIF v1 req'd when using :< URL specifier notation in CLI doc
Status: CLOSED CURRENTRELEASE
Product: Red Hat Directory Server
Classification: Red Hat
Component: Doc - config-command-file-reference (Show other bugs)
7.1
All Linux
medium Severity medium
: DS8.1
: ---
Assigned To: Deon Ballard
Chandrasekar Kannan
: Documentation
: 164167 (view as bug list)
Depends On:
Blocks: 249650
  Show dependency treegraph
 
Reported: 2005-06-15 21:35 EDT by Ulf Weltman
Modified: 2015-01-04 18:18 EST (History)
2 users (show)

See Also:
Fixed In Version: 8.0
Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
Environment:
Last Closed: 2008-02-15 16:52:27 EST
Type: ---
Regression: ---
Mount Type: ---
Documentation: ---
CRM:
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---


Attachments (Terms of Use)

  None (edit)
Description Ulf Weltman 2005-06-15 21:35:53 EDT
Description of problem:
Reading attributes values from a file when running the ldapmodify CLU has been
tripping up people for a while.  The "jpegphoto:< file:///tmp/whee.jpg" method
only works if the LDIF is v1 or later, that is, it contains the line "version:
1".  Otherwise the actual file URL is added as the value.  A note about this in
the CLI doc on PDF page 240 would be useful, not sure if there are other
appropriate spots.

By the way, maybe a "Documentation" component would be useful in Bugzilla? 
There is a "UI - Online Help" but that's different...

Version-Release number of selected component (if applicable):
7.1

How reproducible:
...always

Steps to Reproduce:
1. Read CLI doc, page 240
  
Actual results:
Confusion!

Expected results:
Enlightenment!

Additional info:
Comment 3 Chandrasekar Kannan 2007-10-18 02:30:01 EDT
change priority=medium. these docs are not a high priority for the 8.0 release.
Comment 4 David O'Brien 2007-10-23 21:30:44 EDT
Not critical for 8.0 GA so pushing to 8.1. Reassign all Config, Command, File
Ref to bforte.
Comment 6 Deon Ballard 2008-01-08 22:29:48 EST
Done. 
Text:
"NOTE: The :< URL specifier notation only works if LDIF statement is version 1
or later, meaning version: 1 is used with the ldapmodify command. Otherwise, the
actual file is appended as the attribute value rather than the binary data."

Link:
http://engineering.redhat.com/docbot/en-US/Red_Hat_Directory_Server/8.0/html/Configuration_Command_File_Reference/Configuration_Command_File_Reference-Command_Line_Utilities-ldapmodify.html#Configuration_Command_File_Reference-ldapmodify_Options-Additional_ldapmodify_Options

I also added the note to the :< URL specifier part for the ldif tool. Is that
right? Does that enlighten or cloud?
Comment 7 Ulf Weltman 2008-01-09 02:56:42 EST
It's the file URL that gets appended as the attribute value rather than the
contents of the file (which might be binary, ASCII, or whatever, not necessarily
the jpeg from the example).

"NOTE: The :< URL specifier notation only works if LDIF statement is version 1
or later, meaning version: 1 is inserted in the LDIF. Otherwise, the
actual file URL is appended as the attribute value rather than the file's contents."
Comment 8 Deon Ballard 2008-01-09 12:18:13 EST
Thanks, Ulf. I corrected the notes per your changes.

This link is the same as in comment #6.
Comment 9 Deon Ballard 2008-01-10 00:51:43 EST
*** Bug 164167 has been marked as a duplicate of this bug. ***
Comment 10 Deon Ballard 2008-02-15 16:52:27 EST
CLosing review bugs and content bugs that were fixed in the 8.0 release for the
install, admin, and CLI guides.

Note You need to log in before you can comment on or make changes to this bug.