NAME

lj-fc - Track the people who list you as a friend in LiveJournal

SYNOPSIS

lj-fc [-hinqrs] [-F FriendsOf] [-L LiveJournal]

DESCRIPTION

lj-fc allows you to keep track of the people who have listed you as a friend in the LiveJournal system.

OPTIONS

Supported options are:

lj-fc [-hinqrs] [-F FriendsOf] [-L LiveJournal]

-h
Display command line options

-i
Initialise the list of LiveJournal users who list you as a friend. The list of users who consider you a friend will be displayed.

This mode is the default if there is no saved list of users.

-n
Do not save any changes to the list of LiveJournal users who list you as a friend into the save file.

-q
Do not output anything if nothing has changed

-r
Raw output; this is an output format suitable for feeding into pipes, etc. The format when displaying a summary -s is: 
  LJ_user\tRealName

i.e. the LiveJournal username followed by the real name of the LiveJournal user separated by a tab. When in the default checking mode the output is:

  Change\tLJ_user\tRealName

Where Change is either ADD or DEL depending on what has happened to the given LJ_user.

-s
Display a summary of the LiveJournal users who list you as a friend. Conflicts with -i

-F FriendsOf
The file which holds the list of saved LiveJournal users who list you as a friend. Default is ~/.lj-fc-save

-L LiveJournal
The LiveJournal access configuration file. Please see below for details of this file. Default is ~/.livejournal

USAGE

The first time you run lj-fc it will run in initialisation mode. In this mode it will connect to the LiveJournal server and pull down a copy of your Friends Of list; i.e. the list of other LiveJournal users who list you as a friend. When it has done this lj-fc will display the list of users on your Friends Of list in the following format:

  LJ username      Real name
  ============     ==========
  username_1       real_name_1
  username_2       real_name_2
      :                 :
      :                 :
  username_n       real_name_n

It will also write out this list into the ~/.lj-fc-save file.

On subsequent runs lj-fc will by default run in check mode. In this mode it connects to the LiveJournal server and pulls down a new copy of your Friends Of list. It then compares this list to the version saved in the ~/.lj-fc-save file and displays any difference.

For example if fred has removed you from his friends list and sophie has added you to her friends list then the following output would be produced:

  % lj-fc
  People who have ADDED you to their friends list:


      LJ username   Real name
      ============  ==========
      sophie        Sophie

  People who have REMOVED you from their friends list:

      LJ username  Real name
      ============ ==========
      fred         Fred Bloggs

  %

If your Friends Of list has not changed then the following is produced:

  % lj-fc
  No changes
  %

It should be noted that if raw output is chosen by the use of the -r flag then the output will be different to the above; please see the details of the -r flag above.

FILES

There are a couple of files used by this program:

~/.livejournal
This file stores your LiveJournal access details. Blank lines and lines starting with a # are ignored. All other lines have to be of the form: 
  KEY=VALUE

Where:

  +-------+----------------------------------------------+
  | Key   | Value                                        |
  +-------+----------------------------------------------+
  | USER  | The LiveJournal username to use              |
  | PASS  | The LiveJournal password to use in plaintext |
  | SITE  | The LiveJournal server to use                |
  | PROXY | The web proxy server to use                  |
  +-------+----------------------------------------------+

Both the SITE and PROXY values take the form of hostname[:port].

If you do not specify: USER You will be asked to enter it PASS You will be asked to enter it, but the password will not be echoed to the screen SITE The default value of www.livejournal.com:80 will be used PROXY No proxy server will be used.

~/.lj-fc-save
This file is used by lj-fc to store the state of your Friends Of list in LiveJournal. With this file blank lines and lines starting with a # are ignored and it should be noted that such lines will be removed by lj-fc automatically. All other lines should take the form of: 
  LJ_login=LJ_realname

Where: LJ_login is the LiveJournal login name of the person LJ_username is the real name of the person

SEE ALSO

perl LJ::Simple

BUGS

AUTHOR

Simon Burr <simes@bpfh.net>

LICENSE

Copyright (c) 2002, Simon Burr <simes@bpfh.net> All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

  * Redistributions of source code must retain the above copyright notice,
    this list of conditions and the following disclaimer. 
  * Redistributions in binary form must reproduce the above copyright
    notice, this list of conditions and the following disclaimer in the
    documentation and/or other materials provided with the distribution. 
  * Neither the name of the author nor the names of its contributors may
    be used to endorse or promote products derived from this software
    without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.